@open-mercato/core 0.6.7-develop.6758.1.697eade236 → 0.6.7-develop.6768.1.9d2c4efc43

package/src/modules/customers/backend/customers/people-v2/[id]/page.tsx

@@ -1,6 +1,7 @@
 "use client"
 
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/customers/extension-points'
 import Link from 'next/link'
 import { useRouter, useSearchParams, usePathname } from 'next/navigation'
 import { User, Hash, Users, Building2 } from 'lucide-react'
@@ -502,8 +503,8 @@ export default function PersonDetailV2Page({ params }: { params?: { id?: string
       <PageBody>
         <div className="space-y-4">
           {/* UMES header injection (third-party extensions) */}
-          <InjectionSpot spotId="detail:customers.person:header" context={injectionContext} data={data} />
-          <InjectionSpot spotId="detail:customers.person:status-badges" context={injectionContext} data={data} />
+          <InjectionSpot spotId={extensionPoints.hosts.personHeader.spotId} context={injectionContext} data={data} />
+          <InjectionSpot spotId={extensionPoints.hosts.personStatusBadges.spotId} context={injectionContext} data={data} />
 
           {/* Persistent person header */}
           <PersonDetailHeader
@@ -537,7 +538,7 @@ export default function PersonDetailV2Page({ params }: { params?: { id?: string
                 <CrudForm<PersonEditFormValues>
                   embedded
                   trackDirtyWhenEmbedded
-                  injectionSpotId="crud-form:customers.person"
+                  injectionSpotId={extensionPoints.hosts.personForm.spotId}
                   entityIds={[E.customers.customer_entity, E.customers.customer_person_profile]}
                   schema={formSchema}
                   fields={fields}
@@ -719,7 +720,7 @@ export default function PersonDetailV2Page({ params }: { params?: { id?: string
           })()}
 
           {/* UMES footer injection */}
-          <InjectionSpot spotId="detail:customers.person:footer" context={injectionContext} data={data} />
+          <InjectionSpot spotId={extensionPoints.hosts.personFooter.spotId} context={injectionContext} data={data} />
 
           {/* Schedule Activity Dialog — opened from PlannedActivities "+ Schedule" or other triggers */}
           <ScheduleActivityDialog

package/src/modules/customers/components/CustomerTodosTable.tsx

@@ -1,6 +1,7 @@
 "use client"
 
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/customers/extension-points'
 import Link from 'next/link'
 import { useRouter } from 'next/navigation'
 import type { ColumnDef } from '@tanstack/react-table'
@@ -253,7 +254,7 @@ export function CustomerTodosTable(): React.JSX.Element {
         setSearch(value)
         setPage(1)
       }}
-      perspective={{ tableId: 'customers.todos.list' }}
+      perspective={{ tableId: extensionPoints.hosts.todosTable.tableId }}
       rowActions={(row) => {
         const customerLink = buildCustomerHref(row)
         const todoHref = row.externalHref ?? resolveTodoHref(row.todoSource, row.todoId)

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

@@ -0,0 +1,40 @@
+import {
+  crudFormExtensionHost,
+  dataTableExtensionHost,
+  defineModuleExtensionPoints,
+  injectionExtensionHost,
+} from '@open-mercato/shared/modules/widgets/extension-points'
+
+const detailHost = (spotId: string, source: string) => injectionExtensionHost({
+  family: 'detail',
+  spotId,
+  supported: ['render-widget'],
+  contextContract: 'customers.detail.v1',
+  source,
+})
+
+export const extensionPoints = defineModuleExtensionPoints({
+  moduleId: 'customers',
+  hosts: {
+    companiesTable: dataTableExtensionHost({ tableId: 'customers.companies.list', source: 'backend/customers/companies/page.tsx' }),
+    dealsTable: dataTableExtensionHost({ tableId: 'customers.deals.list', source: 'backend/customers/deals/page.tsx' }),
+    peopleTable: dataTableExtensionHost({ tableId: 'customers.people.list', source: 'backend/customers/people/page.tsx' }),
+    todosTable: dataTableExtensionHost({ tableId: 'customers.todos.list', source: 'components/CustomerTodosTable.tsx' }),
+    companyForm: crudFormExtensionHost({ entityId: 'customers.company', spotId: 'crud-form:customers.company', source: 'backend/customers/companies-v2/[id]/page.tsx' }),
+    dealForm: crudFormExtensionHost({ entityId: 'customers.deal', spotId: 'crud-form:customers.deal', source: 'backend/customers/deals/[id]/page.tsx' }),
+    personForm: crudFormExtensionHost({ entityId: 'customers.person', spotId: 'crud-form:customers.person', source: 'backend/customers/people-v2/[id]/page.tsx' }),
+    companyHeader: detailHost('detail:customers.company:header', 'backend/customers/companies-v2/[id]/page.tsx'),
+    companyStatusBadges: detailHost('detail:customers.company:status-badges', 'backend/customers/companies-v2/[id]/page.tsx'),
+    companyFooter: detailHost('detail:customers.company:footer', 'backend/customers/companies-v2/[id]/page.tsx'),
+    companyLegacyDetails: detailHost('customers.company.detail:details', 'backend/customers/companies/[id]/page.tsx'),
+    dealHeader: detailHost('detail:customers.deal:header', 'backend/customers/deals/[id]/page.tsx'),
+    dealStatusBadges: detailHost('detail:customers.deal:status-badges', 'backend/customers/deals/[id]/page.tsx'),
+    dealFooter: detailHost('detail:customers.deal:footer', 'backend/customers/deals/[id]/page.tsx'),
+    personHeader: detailHost('detail:customers.person:header', 'backend/customers/people-v2/[id]/page.tsx'),
+    personStatusBadges: detailHost('detail:customers.person:status-badges', 'backend/customers/people-v2/[id]/page.tsx'),
+    personFooter: detailHost('detail:customers.person:footer', 'backend/customers/people-v2/[id]/page.tsx'),
+    personLegacyDetails: detailHost('customers.person.detail:details', 'backend/customers/people/[id]/page.tsx'),
+  },
+})
+
+export default extensionPoints

package/src/modules/customers/lib/calendar/format.ts

@@ -2,6 +2,12 @@ const DATE_OPTIONS: Intl.DateTimeFormatOptions = { day: 'numeric', month: 'short
 
 const TIME_OPTIONS: Intl.DateTimeFormatOptions = { hour: 'numeric', minute: '2-digit' }
 
+const NON_CANONICAL_INTL_SPACING = /[\u00a0\u2007\u2009\u202f]/g
+
+function normalizeIntlSpacing(value: string): string {
+  return value.replace(NON_CANONICAL_INTL_SPACING, ' ')
+}
+
 export function formatDateLabel(locale: string, date: Date): string {
   return new Intl.DateTimeFormat(locale, DATE_OPTIONS).format(date)
 }
@@ -9,17 +15,17 @@ export function formatDateLabel(locale: string, date: Date): string {
 export function formatDateRangeLabel(locale: string, from: Date, to: Date): string {
   const formatter = new Intl.DateTimeFormat(locale, DATE_OPTIONS)
   try {
-    return formatter.formatRange(from, to)
+    return normalizeIntlSpacing(formatter.formatRange(from, to))
   } catch {
-    return `${formatter.format(from)} – ${formatter.format(to)}`
+    return normalizeIntlSpacing(`${formatter.format(from)} – ${formatter.format(to)}`)
   }
 }
 
 export function formatTimeRangeLabel(locale: string, start: Date, end: Date): string {
   const formatter = new Intl.DateTimeFormat(locale, TIME_OPTIONS)
   try {
-    return formatter.formatRange(start, end)
+    return normalizeIntlSpacing(formatter.formatRange(start, end))
   } catch {
-    return `${formatter.format(start)} – ${formatter.format(end)}`
+    return normalizeIntlSpacing(`${formatter.format(start)} – ${formatter.format(end)}`)
   }
 }

package/src/modules/customers/lib/dealsSummaryQueries.ts

@@ -0,0 +1,211 @@
+import type { EntityManager as CoreEntityManager } from '@mikro-orm/core'
+import type { EntityManager as PgEntityManager } from '@mikro-orm/postgresql'
+import { fetchStuckDealIds } from './stuckDeals'
+
+type DateWindow = {
+  start: Date
+  end: Date
+}
+
+export type OpenPipelineRow = {
+  stage: string | null
+  currency: string | null
+  total: string | number | null
+  count: string | number
+  owner_user_id: string | null
+}
+
+export type WindowSumRow = {
+  currency: string | null
+  current_total: string | number | null
+  current_count: string | number
+  previous_total: string | number | null
+  previous_count: string | number
+}
+
+export type WinLossRow = {
+  current_won: string | number
+  current_lost: string | number
+  previous_won: string | number
+  previous_lost: string | number
+}
+
+export type WinRateMonthRow = {
+  period: string
+  won: string | number
+  lost: string | number
+}
+
+export type DealsSummaryQueryRows = {
+  openRows: OpenPipelineRow[]
+  inflowRows: WindowSumRow[]
+  wonRows: WindowSumRow[]
+  winLossRows: WinLossRow[]
+  seriesRows: WinRateMonthRow[]
+  overdueRows: Array<{ id: string }>
+  openStuckIds: string[]
+}
+
+export type DealsSummaryQueryInput = {
+  em: CoreEntityManager
+  tenantId: string
+  organizationIds: string[]
+  currentQuarter: DateWindow
+  previousQuarter: DateWindow
+  seriesStart: Date
+}
+
+type SqlPredicate = {
+  clause: string
+  values: string[]
+}
+
+export function buildOpenDealPredicate(statuses: readonly string[]): SqlPredicate {
+  if (statuses.length === 0) {
+    throw new Error('[internal] Open-deal predicate requires at least one status')
+  }
+
+  const placeholders = statuses.map(() => '?').join(',')
+  return {
+    clause: `status IN (${placeholders}) AND closure_outcome IS NULL`,
+    values: [...statuses],
+  }
+}
+
+export async function loadDealsSummaryQueryRows(input: DealsSummaryQueryInput): Promise<DealsSummaryQueryRows> {
+  if (input.organizationIds.length === 0) {
+    throw new Error('[internal] Deals summary query requires an organization scope')
+  }
+
+  const connection = input.em.getConnection()
+  const organizationPlaceholders = input.organizationIds.map(() => '?').join(',')
+  const scopeWhere = `tenant_id = ? AND organization_id IN (${organizationPlaceholders}) AND deleted_at IS NULL`
+  const scopeValues: Array<string | number | null> = [input.tenantId, ...input.organizationIds]
+  const openDealsPredicate = buildOpenDealPredicate(['open', 'in_progress'])
+
+  const openRows = await connection.execute<OpenPipelineRow[]>(
+    `SELECT
+        pipeline_stage AS stage,
+        UPPER(COALESCE(value_currency, '')) AS currency,
+        COALESCE(SUM(value_amount), 0) AS total,
+        COUNT(*) AS count,
+        owner_user_id
+      FROM customer_deals
+      WHERE ${scopeWhere} AND ${openDealsPredicate.clause}
+      GROUP BY pipeline_stage, UPPER(COALESCE(value_currency, '')), owner_user_id`,
+    [...scopeValues, ...openDealsPredicate.values],
+  )
+
+  const inflowRows = await connection.execute<WindowSumRow[]>(
+    `SELECT
+        UPPER(COALESCE(value_currency, '')) AS currency,
+        COALESCE(SUM(value_amount) FILTER (WHERE created_at >= ? AND created_at < ?), 0) AS current_total,
+        COUNT(*) FILTER (WHERE created_at >= ? AND created_at < ?) AS current_count,
+        COALESCE(SUM(value_amount) FILTER (WHERE created_at >= ? AND created_at < ?), 0) AS previous_total,
+        COUNT(*) FILTER (WHERE created_at >= ? AND created_at < ?) AS previous_count
+      FROM customer_deals
+      WHERE ${scopeWhere} AND ${openDealsPredicate.clause}
+      GROUP BY UPPER(COALESCE(value_currency, ''))`,
+    [
+      input.currentQuarter.start.toISOString(),
+      input.currentQuarter.end.toISOString(),
+      input.currentQuarter.start.toISOString(),
+      input.currentQuarter.end.toISOString(),
+      input.previousQuarter.start.toISOString(),
+      input.previousQuarter.end.toISOString(),
+      input.previousQuarter.start.toISOString(),
+      input.previousQuarter.end.toISOString(),
+      ...scopeValues,
+      ...openDealsPredicate.values,
+    ],
+  )
+
+  const wonRows = await connection.execute<WindowSumRow[]>(
+    `SELECT
+        UPPER(COALESCE(value_currency, '')) AS currency,
+        COALESCE(SUM(value_amount) FILTER (WHERE updated_at >= ? AND updated_at < ?), 0) AS current_total,
+        COUNT(*) FILTER (WHERE updated_at >= ? AND updated_at < ?) AS current_count,
+        COALESCE(SUM(value_amount) FILTER (WHERE updated_at >= ? AND updated_at < ?), 0) AS previous_total,
+        COUNT(*) FILTER (WHERE updated_at >= ? AND updated_at < ?) AS previous_count
+      FROM customer_deals
+      WHERE ${scopeWhere} AND (status = 'win' OR closure_outcome = 'won')
+      GROUP BY UPPER(COALESCE(value_currency, ''))`,
+    [
+      input.currentQuarter.start.toISOString(),
+      input.currentQuarter.end.toISOString(),
+      input.currentQuarter.start.toISOString(),
+      input.currentQuarter.end.toISOString(),
+      input.previousQuarter.start.toISOString(),
+      input.previousQuarter.end.toISOString(),
+      input.previousQuarter.start.toISOString(),
+      input.previousQuarter.end.toISOString(),
+      ...scopeValues,
+    ],
+  )
+
+  const winLossRows = await connection.execute<WinLossRow[]>(
+    `SELECT
+        COUNT(*) FILTER (WHERE (status = 'win' OR closure_outcome = 'won') AND updated_at >= ? AND updated_at < ?) AS current_won,
+        COUNT(*) FILTER (WHERE (status = 'loose' OR closure_outcome = 'lost') AND updated_at >= ? AND updated_at < ?) AS current_lost,
+        COUNT(*) FILTER (WHERE (status = 'win' OR closure_outcome = 'won') AND updated_at >= ? AND updated_at < ?) AS previous_won,
+        COUNT(*) FILTER (WHERE (status = 'loose' OR closure_outcome = 'lost') AND updated_at >= ? AND updated_at < ?) AS previous_lost
+      FROM customer_deals
+      WHERE ${scopeWhere}`,
+    [
+      input.currentQuarter.start.toISOString(),
+      input.currentQuarter.end.toISOString(),
+      input.currentQuarter.start.toISOString(),
+      input.currentQuarter.end.toISOString(),
+      input.previousQuarter.start.toISOString(),
+      input.previousQuarter.end.toISOString(),
+      input.previousQuarter.start.toISOString(),
+      input.previousQuarter.end.toISOString(),
+      ...scopeValues,
+    ],
+  )
+
+  const seriesRows = await connection.execute<WinRateMonthRow[]>(
+    `SELECT
+        to_char(date_trunc('month', updated_at AT TIME ZONE 'UTC'), 'YYYY-MM') AS period,
+        COUNT(*) FILTER (WHERE status = 'win' OR closure_outcome = 'won') AS won,
+        COUNT(*) FILTER (WHERE status = 'loose' OR closure_outcome = 'lost') AS lost
+      FROM customer_deals
+      WHERE ${scopeWhere} AND updated_at >= ?
+      GROUP BY 1`,
+    [...scopeValues, input.seriesStart.toISOString()],
+  )
+
+  const overdueDealsPredicate = buildOpenDealPredicate(['open'])
+  const overdueRows = await connection.execute<Array<{ id: string }>>(
+    `SELECT id FROM customer_deals
+      WHERE ${scopeWhere} AND ${overdueDealsPredicate.clause} AND expected_close_at IS NOT NULL AND expected_close_at < CURRENT_DATE`,
+    [...scopeValues, ...overdueDealsPredicate.values],
+  )
+
+  const stuckIdLists = await Promise.all(
+    input.organizationIds.map((organizationId) =>
+      fetchStuckDealIds(input.em as unknown as PgEntityManager, organizationId, input.tenantId),
+    ),
+  )
+  const stuckIdValues = Array.from(new Set(stuckIdLists.flat()))
+  let openStuckIds: string[] = []
+  if (stuckIdValues.length > 0) {
+    const stuckPlaceholders = stuckIdValues.map(() => '?').join(',')
+    const openStuckRows: Array<{ id: string }> = await connection.execute<Array<{ id: string }>>(
+      `SELECT id FROM customer_deals
+        WHERE ${scopeWhere} AND ${openDealsPredicate.clause} AND id IN (${stuckPlaceholders})`,
+      [...scopeValues, ...openDealsPredicate.values, ...stuckIdValues],
+    )
+    openStuckIds = openStuckRows.map((row) => row.id)
+  }
+
+  return {
+    openRows,
+    inflowRows,
+    wonRows,
+    winLossRows,
+    seriesRows,
+    overdueRows,
+    openStuckIds,
+  }
+}

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

@@ -1,5 +1,6 @@
 "use client"
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/data_sync/extension-points'
 import Link from 'next/link'
 import { useRouter } from 'next/navigation'
 import { Page, PageBody } from '@open-mercato/ui/backend/Page'
@@ -984,7 +985,7 @@ export default function SyncRunsDashboardPage() {
           searchValue={search}
           onSearchChange={(value) => { setSearch(value); setPage(1) }}
           searchPlaceholder={t('data_sync.dashboard.searchPlaceholder')}
-          perspective={{ tableId: 'data_sync.runs' }}
+          perspective={{ tableId: extensionPoints.hosts.runsTable.tableId }}
           onRowClick={(row) => {
             router.push(`/backend/data-sync/runs/${encodeURIComponent(row.id)}`)
           }}

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

@@ -0,0 +1,10 @@
+import { dataTableExtensionHost, defineModuleExtensionPoints } from '@open-mercato/shared/modules/widgets/extension-points'
+
+export const extensionPoints = defineModuleExtensionPoints({
+  moduleId: 'data_sync',
+  hosts: {
+    runsTable: dataTableExtensionHost({ tableId: 'data_sync.runs', source: 'backend/data-sync/page.tsx' }),
+  },
+})
+
+export default extensionPoints

package/src/modules/directory/backend/directory/organizations/page.tsx

@@ -1,5 +1,6 @@
 "use client"
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/directory/extension-points'
 import Link from 'next/link'
 import { useQuery, useQueryClient } from '@tanstack/react-query'
 import type { ColumnDef } from '@tanstack/react-table'
@@ -271,7 +272,7 @@ export default function DirectoryOrganizationsPage() {
             setPage(1)
           }}
           sortable={false}
-          perspective={{ tableId: 'directory.organizations.list' }}
+          perspective={{ tableId: extensionPoints.hosts.organizationsTable.tableId }}
           rowActions={(row) => (
             canManage ? (
               <RowActions

package/src/modules/directory/backend/directory/tenants/page.tsx

@@ -1,5 +1,6 @@
 "use client"
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/directory/extension-points'
 import Link from 'next/link'
 import { useQuery, useQueryClient } from '@tanstack/react-query'
 import type { ColumnDef, SortingState } from '@tanstack/react-table'
@@ -193,7 +194,7 @@ export default function DirectoryTenantsPage() {
           sortable
           sorting={sorting}
           onSortingChange={(state) => { setSorting(state); setPage(1) }}
-          perspective={{ tableId: 'directory.tenants.list' }}
+          perspective={{ tableId: extensionPoints.hosts.tenantsTable.tableId }}
           rowActions={(row) => (
             canManage ? (
               <RowActions

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

@@ -0,0 +1,11 @@
+import { dataTableExtensionHost, defineModuleExtensionPoints } from '@open-mercato/shared/modules/widgets/extension-points'
+
+export const extensionPoints = defineModuleExtensionPoints({
+  moduleId: 'directory',
+  hosts: {
+    organizationsTable: dataTableExtensionHost({ tableId: 'directory.organizations.list', source: 'backend/directory/organizations/page.tsx' }),
+    tenantsTable: dataTableExtensionHost({ tableId: 'directory.tenants.list', source: 'backend/directory/tenants/page.tsx' }),
+  },
+})
+
+export default extensionPoints

package/src/modules/entities/backend/entities/user/[entityId]/records/page.tsx

@@ -1,5 +1,7 @@
 "use client"
 import * as React from 'react'
+import { resolveExtensionPointPattern } from '@open-mercato/shared/modules/widgets/extension-points'
+import { extensionPoints } from '@open-mercato/core/modules/entities/extension-points'
 import { useSearchParams } from 'next/navigation'
 import type { ColumnDef, SortingState } from '@tanstack/react-table'
 import { filterCustomFieldDefs, useCustomFieldDefs } from '@open-mercato/ui/backend/utils/customFieldDefs'
@@ -383,7 +385,9 @@ export RECORD_ID="<record uuid>"`}</code></pre>
           actions={actions}
           columns={columns}
           data={data}
-          perspective={{ tableId: `entities.user.records.${entityId}` }}
+          perspective={{
+            tableId: resolveExtensionPointPattern(extensionPoints.hosts.userRecordsTable.pattern, { entityId }),
+          }}
           exporter={exportConfig}
           filters={baseFilters}
           filterValues={filterValues}

package/src/modules/entities/components/SystemEntitiesTable.tsx

@@ -1,5 +1,6 @@
 "use client"
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/entities/extension-points'
 import { useQuery } from '@tanstack/react-query'
 import type { ColumnDef, SortingState } from '@tanstack/react-table'
 import { DataTable } from '@open-mercato/ui/backend/DataTable'
@@ -73,7 +74,7 @@ export default function SystemEntitiesTable() {
       sortable
       sorting={sorting}
       onSortingChange={setSorting}
-      perspective={{ tableId: 'entities.system.list' }}
+      perspective={{ tableId: extensionPoints.hosts.systemEntitiesTable.tableId }}
       rowActions={(row) => (
         <RowActions
           items={[

package/src/modules/entities/components/UserEntitiesTable.tsx

@@ -1,6 +1,7 @@
 
 "use client"
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/entities/extension-points'
 import Link from 'next/link'
 import { useQuery } from '@tanstack/react-query'
 import type { ColumnDef, SortingState } from '@tanstack/react-table'
@@ -96,7 +97,7 @@ export default function UserEntitiesTable() {
       sortable
       sorting={sorting}
       onSortingChange={setSorting}
-      perspective={{ tableId: 'entities.user.list' }}
+      perspective={{ tableId: extensionPoints.hosts.userEntitiesTable.tableId }}
       emptyState={(
         <ListEmptyState
           entityName={t('entities.user.table.title', 'User Entities')}

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

@@ -0,0 +1,18 @@
+import { dataTableExtensionHost, defineModuleExtensionPoints, injectionExtensionHost } from '@open-mercato/shared/modules/widgets/extension-points'
+
+export const extensionPoints = defineModuleExtensionPoints({
+  moduleId: 'entities',
+  hosts: {
+    systemEntitiesTable: dataTableExtensionHost({ tableId: 'entities.system.list', source: 'components/SystemEntitiesTable.tsx' }),
+    userEntitiesTable: dataTableExtensionHost({ tableId: 'entities.user.list', source: 'components/UserEntitiesTable.tsx' }),
+    userRecordsTable: injectionExtensionHost({
+      family: 'entity',
+      pattern: 'data-table:entities.user.records.{entityId}',
+      parameters: { entityId: { source: 'route.params.entityId' } },
+      supported: ['render-widget', 'headless-widget', 'column-widget', 'row-action', 'bulk-action', 'filter-widget'],
+      source: 'backend/entities/user/[entityId]/records/page.tsx',
+    }),
+  },
+})
+
+export default extensionPoints

package/src/modules/integrations/backend/integrations/[id]/page.tsx

@@ -1,5 +1,6 @@
 "use client"
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/integrations/extension-points'
 import { usePathname, useRouter, useSearchParams } from 'next/navigation'
 import { z } from 'zod'
 import { Page, PageBody } from '@open-mercato/ui/backend/Page'
@@ -31,7 +32,6 @@ import { raiseCrudError } from '@open-mercato/ui/backend/utils/serverErrors'
 import { useT } from '@open-mercato/shared/lib/i18n/context'
 import { cn } from '@open-mercato/shared/lib/utils'
 import {
-  LEGACY_INTEGRATION_DETAIL_TABS_SPOT_ID,
   type CredentialFieldType,
   type IntegrationCredentialField,
   type IntegrationDetailBuiltInTab,
@@ -530,7 +530,7 @@ export default function IntegrationDetailPage({ params }: IntegrationDetailPageP
   }, [logLevel, resolveCurrentIntegrationId])
 
   const detailWidgetSpotId = React.useMemo(
-    () => resolveIntegrationDetailWidgetSpotId(detail?.integration ?? null, LEGACY_INTEGRATION_DETAIL_TABS_SPOT_ID),
+    () => resolveIntegrationDetailWidgetSpotId(detail?.integration ?? null, extensionPoints.hosts.legacyDetailTabs.spotId),
     [detail?.integration],
   )
   const mutationContextId = React.useMemo(

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

@@ -0,0 +1,27 @@
+import { defineModuleExtensionPoints, injectionExtensionHost } from '@open-mercato/shared/modules/widgets/extension-points'
+
+export const extensionPoints = defineModuleExtensionPoints({
+  moduleId: 'integrations',
+  hosts: {
+    detail: injectionExtensionHost({
+      family: 'integration',
+      pattern: 'integrations.detail:{integrationId}',
+      parameters: {
+        integrationId: { source: 'IntegrationDefinition.id', pattern: '^[a-z0-9_]+$' },
+      },
+      fallbacks: ['integrations.detail:tabs'],
+      supported: ['render-widget'],
+      contextContract: 'integrations.detail.v1',
+      source: 'backend/integrations/[id]/page.tsx',
+    }),
+    legacyDetailTabs: injectionExtensionHost({
+      family: 'integration',
+      spotId: 'integrations.detail:tabs',
+      supported: ['render-widget'],
+      contextContract: 'integrations.detail.v1',
+      source: 'backend/integrations/[id]/page.tsx',
+    }),
+  },
+})
+
+export default extensionPoints

package/src/modules/messages/components/ComposeMessagePageClient.tsx

@@ -1,6 +1,7 @@
 "use client"
 
 import { useRouter } from 'next/navigation'
+import { extensionPoints } from '@open-mercato/core/modules/messages/extension-points'
 import { MessageComposer } from '@open-mercato/ui/backend/messages'
 // UMES extension surface — compose page injection spot (SPEC-045d §9.3a).
 // Channel provider packages inject "composer capabilities" widgets here
@@ -21,7 +22,7 @@ export function ComposeMessagePageClient() {
         scoping) into this spot purely as additional UI siblings.
       */}
       <InjectionSpot
-        spotId="crud-form:messages:message:fields"
+        spotId={extensionPoints.hosts.composeFields.spotId}
         context={{ form: 'compose' }}
         data={{}}
       />

package/src/modules/messages/components/MessageDetailPageClient.tsx

@@ -1,6 +1,7 @@
 "use client"
 
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/messages/extension-points'
 import { MessageComposer } from '@open-mercato/ui/backend/messages'
 import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
 import { useConfirmDialog } from '@open-mercato/ui/backend/confirm-dialog'
@@ -94,7 +95,7 @@ function MessageConversationDetailItem({
 
           {/* UMES — channel payload renderer mounts here (channel-linked emails, Slack blocks, etc.). */}
           <InjectionSpot
-            spotId="detail:messages:message:body:after"
+            spotId={extensionPoints.hosts.detailBodyAfter.spotId}
             context={{ messageId }}
             data={state.detail}
           />
@@ -105,7 +106,7 @@ function MessageConversationDetailItem({
               `userFeatures` lets feature-gated widgets (e.g. the channel reassignment editor,
               gated on `communication_channels.assign`) render their controls for permitted users. */}
           <InjectionSpot
-            spotId="detail:messages:message:sidebar"
+            spotId={extensionPoints.hosts.detailSidebar.spotId}
             context={{ messageId, userFeatures }}
             data={state.detail}
           />

package/src/modules/messages/components/MessagesInboxPageClient.tsx

@@ -1,6 +1,7 @@
 "use client"
 
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/messages/extension-points'
 import Link from 'next/link'
 import { useRouter } from 'next/navigation'
 import { useQuery, useQueryClient } from '@tanstack/react-query'
@@ -369,7 +370,7 @@ export function MessagesInboxPageClient() {
         // UMES extension surface — opt into widget injection at:
         //   data-table:messages:columns / :row-actions / :bulk-actions / :filters / :toolbar / :search-trailing
         // (SPEC-045d §9.3a — communication_channels hub renders channel badge + delivery status here)
-        extensionTableId="messages"
+        extensionTableId={extensionPoints.hosts.inboxTable.tableId}
         columns={columns}
         data={rows}
         bulkActions={bulkActions}

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

@@ -0,0 +1,13 @@
+import { dataTableExtensionHost, defineModuleExtensionPoints, injectionExtensionHost } from '@open-mercato/shared/modules/widgets/extension-points'
+
+export const extensionPoints = defineModuleExtensionPoints({
+  moduleId: 'messages',
+  hosts: {
+    inboxTable: dataTableExtensionHost({ tableId: 'messages', source: 'components/MessagesInboxPageClient.tsx' }),
+    composeFields: injectionExtensionHost({ family: 'generic', spotId: 'crud-form:messages:message:fields', supported: ['render-widget'], source: 'components/ComposeMessagePageClient.tsx' }),
+    detailBodyAfter: injectionExtensionHost({ family: 'detail', spotId: 'detail:messages:message:body:after', supported: ['render-widget'], source: 'components/MessageDetailPageClient.tsx' }),
+    detailSidebar: injectionExtensionHost({ family: 'detail', spotId: 'detail:messages:message:sidebar', supported: ['render-widget'], source: 'components/MessageDetailPageClient.tsx' }),
+  },
+})
+
+export default extensionPoints

package/src/modules/payment_gateways/backend/payment-gateways/page.tsx

@@ -1,5 +1,6 @@
 "use client"
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/payment_gateways/extension-points'
 import { useSearchParams } from 'next/navigation'
 import type { ColumnDef } from '@tanstack/react-table'
 import type { FilterDef, FilterValues } from '@open-mercato/ui/backend/FilterBar'
@@ -472,7 +473,7 @@ export default function PaymentTransactionsPage() {
           searchValue={search}
           onSearchChange={(value) => { setSearch(value); setPage(1) }}
           searchPlaceholder={t('payment_gateways.transactions.searchPlaceholder', 'Search by payment, transaction, session, or gateway id')}
-          perspective={{ tableId: 'payment_gateways.transactions.list' }}
+          perspective={{ tableId: extensionPoints.hosts.transactionsTable.tableId }}
           pagination={{ page, pageSize: 20, total, totalPages, onPageChange: setPage }}
           isLoading={isLoading}
           onRowClick={(row) => setSelectedId((current) => current === row.id ? null : row.id)}
@@ -691,7 +692,7 @@ export default function PaymentTransactionsPage() {
                         className="p-4"
                       />
                       <InjectionSpot
-                        spotId="admin.page:payment-gateways/transactions:after"
+                        spotId={extensionPoints.hosts.transactionsAfter.spotId}
                         context={{ selectedPaymentId: detail.transaction.paymentId }}
                       />
                     </div>