@open-mercato/core 0.4.11-develop.1309.4b37381a7a → 0.4.11-develop.1347.c693e6dfee

package/src/modules/customers/api/dashboard/widgets/customer-todos/route.ts

@@ -2,13 +2,17 @@ import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
-import { CustomerEntity, CustomerTodoLink } from '../../../../data/entities'
 import { resolveWidgetScope, type WidgetScopeContext } from '../utils'
+import { resolveCustomerInteractionFeatureFlags } from '../../../../lib/interactionFeatureFlags'
+import { CUSTOMER_INTERACTION_TODO_ADAPTER_SOURCE } from '../../../../lib/interactionCompatibility'
 import type { QueryEngine } from '@open-mercato/shared/lib/query/types'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
-import type { FilterQuery } from '@mikro-orm/core'
-import type { EntityId } from '@open-mercato/shared/modules/entities'
-import { decryptEntitiesWithFallbackScope } from '@open-mercato/shared/lib/encryption/subscriber'
+import {
+  listLegacyTodoRows,
+  listCanonicalTodoRows,
+  sortTodoRows,
+  type CustomerTodoRow,
+} from '../../../../lib/todoCompatibility'
 
 const querySchema = z.object({
   limit: z.coerce.number().min(1).max(20).default(5),
@@ -47,135 +51,73 @@ async function resolveContext(req: Request, translate: (key: string, fallback?:
   }
 }
 
-type TodoSummary = {
-  id: string
-  title: string | null
-}
-
-const TODO_TITLE_FIELDS = ['title', 'subject', 'name', 'summary', 'text', 'description'] as const
-
-function extractTodoTitle(record: Record<string, unknown>): string | null {
-  for (const key of TODO_TITLE_FIELDS) {
-    const value = record[key]
-    if (typeof value === 'string' && value.trim().length > 0) {
-      return value.trim()
-    }
-  }
-  return null
-}
-
-async function resolveTodoSummaries(
-  queryEngine: QueryEngine,
-  links: CustomerTodoLink[],
-  tenantId: string,
-  organizationIds: string[] | null
-): Promise<Map<string, TodoSummary>> {
-  const results = new Map<string, TodoSummary>()
-  if (!links.length) return results
-
-  const idsBySource = new Map<string, Set<string>>()
-  for (const link of links) {
-    const source = typeof link.todoSource === 'string' && link.todoSource.length > 0 ? link.todoSource : 'unknown'
-    const id = String(link.todoId ?? '')
-    if (!id) continue
-    if (!idsBySource.has(source)) idsBySource.set(source, new Set<string>())
-    idsBySource.get(source)!.add(id)
-  }
-
-  const scopedOrgIds = Array.isArray(organizationIds)
-    ? Array.from(new Set(organizationIds.filter((id) => typeof id === 'string' && id.length > 0)))
-    : null
-
-  for (const [source, idSet] of idsBySource.entries()) {
-    const ids = Array.from(idSet)
-    if (ids.length === 0 || source === 'unknown') continue
-    try {
-      const requestedFields = Array.from(new Set(['id', ...TODO_TITLE_FIELDS]))
-      const queryResult = await queryEngine.query<Record<string, unknown>>(source as EntityId, {
-        tenantId,
-        organizationIds: scopedOrgIds && scopedOrgIds.length > 0 ? scopedOrgIds : undefined,
-        filters: { id: { $in: ids } },
-        fields: requestedFields,
-        includeCustomFields: false,
-        page: { page: 1, pageSize: Math.max(ids.length, 1) },
-      })
-      for (const item of queryResult.items ?? []) {
-        if (!item || typeof item !== 'object') continue
-        const raw = item as Record<string, unknown>
-        const todoId = typeof raw.id === 'string' && raw.id.length > 0 ? raw.id : String(raw.id ?? '')
-        if (!todoId) continue
-        const title = extractTodoTitle(raw)
-        results.set(`${source}:${todoId}`, { id: todoId, title })
-      }
-    } catch (err) {
-      console.warn(`customers.widgets.todos: failed to resolve todos for source ${source}`, err)
-    }
-  }
-
-  return results
-}
-
 export async function GET(req: Request) {
   const { translate } = await resolveTranslations()
   try {
     const { container, em, tenantId, organizationIds, limit } = await resolveContext(req, translate)
-    const whereOrganization = Array.isArray(organizationIds)
-      ? organizationIds.length === 1
-        ? organizationIds[0]
-        : { $in: Array.from(new Set(organizationIds)) }
-      : null
-
-    const linkFilters = {
-      tenantId,
-      ...(whereOrganization ? { organizationId: whereOrganization } : {}),
-      entity: {
-        deletedAt: null,
-      } as FilterQuery<CustomerEntity>,
-    } as FilterQuery<CustomerTodoLink>
-
-    const links = await em.find(
-      CustomerTodoLink,
-      linkFilters,
-      {
-        limit,
-        orderBy: { createdAt: 'desc' },
-        populate: ['entity'],
-      }
-    )
-    await decryptEntitiesWithFallbackScope(links, {
-      em,
+    const auth = {
       tenantId,
-      organizationId: organizationIds?.[0] ?? null,
-    })
-
-    const queryEngine = (container.resolve('queryEngine') as QueryEngine)
-    const todoSummaries = await resolveTodoSummaries(queryEngine, links, tenantId, organizationIds)
-
-    const items = links.map((link) => {
-      const entity = link.entity
-      const entityRecord = entity && typeof entity !== 'string' ? (entity as CustomerEntity) : null
-      const todoKey = `${link.todoSource}:${link.todoId}`
-      const summary = todoSummaries.get(todoKey) ?? null
+      orgId: organizationIds?.[0] ?? null,
+      sub: 'customers.dashboard.todos',
+    }
+    const flags = await resolveCustomerInteractionFeatureFlags(container, tenantId)
+    const rows = flags.unified
+      ? (await listCanonicalTodoRows(
+          em,
+          container,
+          auth,
+          organizationIds?.[0] ?? null,
+          organizationIds ?? null,
+        )).items
+      : await Promise.all([
+          listLegacyTodoRows(
+            em,
+            container.resolve('queryEngine') as QueryEngine,
+            tenantId,
+            organizationIds ?? null,
+            undefined,
+          ),
+          listCanonicalTodoRows(
+            em,
+            container,
+            auth,
+            organizationIds?.[0] ?? null,
+            organizationIds ?? null,
+            {
+              includeDeleted: true,
+              source: CUSTOMER_INTERACTION_TODO_ADAPTER_SOURCE,
+            },
+          ),
+        ]).then(([legacyRows, canonicalRows]) =>
+          sortTodoRows([
+            ...legacyRows.filter((row) => !canonicalRows.bridgeIds.has(row.todoId)),
+            ...canonicalRows.items,
+          ]),
+        )
+
+    const items = rows.slice(0, limit).map((row: CustomerTodoRow) => {
+      const entity = row.customer ?? null
       return {
-        id: link.id,
-        todoId: link.todoId,
-        todoSource: link.todoSource,
-        todoTitle: summary?.title ?? null,
-        createdAt: link.createdAt.toISOString(),
-        organizationId: link.organizationId,
-        entity: entityRecord
+        id: row.id,
+        todoId: row.todoId,
+        todoSource: row.todoSource,
+        todoTitle: row.todoTitle ?? null,
+        createdAt: row.createdAt,
+        organizationId: row.organizationId ?? null,
+        _integrations: row._integrations ?? undefined,
+        entity: entity?.id
           ? {
-              id: entityRecord.id,
-              displayName: entityRecord.displayName,
-              kind: entityRecord.kind,
-              ownerUserId: entityRecord.ownerUserId,
+              id: entity.id,
+              displayName: entity.displayName ?? null,
+              kind: entity.kind ?? null,
+              ownerUserId: null,
             }
           : {
-              id: typeof entity === 'string' ? entity : null,
-              displayName: null,
-              kind: null,
-              ownerUserId: null,
-            },
+            id: null,
+            displayName: null,
+            kind: null,
+            ownerUserId: null,
+          },
       }
     })
 
@@ -198,6 +140,7 @@ const customerTodoWidgetItemSchema = z.object({
   todoSource: z.string(),
   todoTitle: z.string().nullable().optional(),
   createdAt: z.string(),
+  _integrations: z.record(z.string(), z.unknown()).optional(),
   organizationId: z.string().uuid().nullable().optional(),
   entity: z
     .object({
@@ -222,8 +165,8 @@ export const openApi: OpenApiRouteDoc = {
   summary: 'Customer todos widget',
   methods: {
     GET: {
-      summary: 'Fetch recent customer todo links',
-      description: 'Returns the most recently created todo links for display on dashboards.',
+      summary: 'Fetch recent customer tasks',
+      description: 'Returns the most recent customer tasks for display on dashboards, including legacy compatibility rows when needed.',
       query: querySchema,
       responses: [
         { status: 200, description: 'Widget payload', schema: customerTodoWidgetResponseSchema },

package/src/modules/customers/api/interactions/tasks/route.ts

@@ -0,0 +1,122 @@
+import { NextResponse } from 'next/server'
+import { z } from 'zod'
+import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
+import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { parseBooleanToken } from '@open-mercato/shared/lib/boolean'
+import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import type { QueryEngine } from '@open-mercato/shared/lib/query/types'
+import { createCustomersCrudOpenApi, createPagedListResponseSchema } from '../../openapi'
+import { resolveCustomerInteractionFeatureFlags } from '../../../lib/interactionFeatureFlags'
+import { resolveCustomersRequestContext } from '../../../lib/interactionRequestContext'
+import { CUSTOMER_INTERACTION_TODO_ADAPTER_SOURCE } from '../../../lib/interactionCompatibility'
+import {
+  filterTodoRows,
+  listCanonicalTodoRows,
+  listLegacyTodoRows,
+  normalizeTodoSearch,
+  paginateTodoRows,
+  sortTodoRows,
+} from '../../../lib/todoCompatibility'
+
+const querySchema = z.object({
+  page: z.coerce.number().min(1).default(1),
+  pageSize: z.coerce.number().min(1).max(100).default(50),
+  search: z.string().optional(),
+  all: z.string().optional(),
+  entityId: z.string().uuid().optional(),
+})
+
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['customers.interactions.view'] },
+}
+
+export async function GET(request: Request): Promise<Response> {
+  const { translate } = await resolveTranslations()
+  try {
+    const { auth, em, organizationIds, container, selectedOrganizationId } =
+      await resolveCustomersRequestContext(request)
+    const query = querySchema.parse(Object.fromEntries(new URL(request.url).searchParams))
+    const flags = await resolveCustomerInteractionFeatureFlags(container, auth.tenantId)
+    const exportAll = parseBooleanToken(query.all) === true
+    const search = normalizeTodoSearch(query.search)
+    const queryEngine = container.resolve('queryEngine') as QueryEngine
+
+    const mergedRows = flags.unified
+      ? (await listCanonicalTodoRows(
+          em,
+          container,
+          auth,
+          selectedOrganizationId,
+          organizationIds,
+          { entityId: query.entityId },
+        )).items
+      : await Promise.all([
+          listLegacyTodoRows(em, queryEngine, auth.tenantId, organizationIds, query.entityId),
+          listCanonicalTodoRows(
+            em,
+            container,
+            auth,
+            selectedOrganizationId,
+            organizationIds,
+            {
+              entityId: query.entityId,
+              includeDeleted: true,
+              source: CUSTOMER_INTERACTION_TODO_ADAPTER_SOURCE,
+            },
+          ),
+        ]).then(([legacyRows, canonicalRows]) => [
+          ...legacyRows.filter((row) => !canonicalRows.bridgeIds.has(row.todoId)),
+          ...canonicalRows.items,
+        ])
+
+    const filteredRows = filterTodoRows(sortTodoRows(mergedRows), search)
+    const paged = paginateTodoRows(filteredRows, query.page, query.pageSize, exportAll)
+
+    return NextResponse.json({
+      items: paged.items,
+      total: paged.total,
+      page: paged.page,
+      pageSize: paged.pageSize,
+      totalPages: paged.totalPages,
+    })
+  } catch (err) {
+    if (err instanceof CrudHttpError) {
+      return NextResponse.json(err.body, { status: err.status })
+    }
+    if (err instanceof z.ZodError) {
+      return NextResponse.json({ error: translate('customers.errors.validationFailed', 'Validation failed'), details: err.issues }, { status: 400 })
+    }
+    console.error('customers.interactions.tasks.get failed', err)
+    return NextResponse.json({ error: translate('customers.errors.internalError', 'Internal server error') }, { status: 500 })
+  }
+}
+
+const todoItemSchema = z.object({
+  id: z.string(),
+  todoId: z.string(),
+  todoSource: z.string(),
+  todoTitle: z.string().nullable(),
+  todoIsDone: z.boolean().nullable(),
+  todoPriority: z.number().nullable().optional(),
+  todoSeverity: z.string().nullable().optional(),
+  todoDescription: z.string().nullable().optional(),
+  todoDueAt: z.string().nullable().optional(),
+  todoCustomValues: z.record(z.string(), z.unknown()).nullable().optional(),
+  todoOrganizationId: z.string().nullable(),
+  organizationId: z.string(),
+  tenantId: z.string(),
+  createdAt: z.string(),
+  externalHref: z.string().nullable().optional(),
+  _integrations: z.record(z.string(), z.unknown()).optional(),
+  customer: z.object({
+    id: z.string().nullable(),
+    displayName: z.string().nullable(),
+    kind: z.string().nullable(),
+  }),
+})
+
+export const openApi: OpenApiRouteDoc = createCustomersCrudOpenApi({
+  resourceName: 'CustomerTask',
+  querySchema,
+  listResponseSchema: createPagedListResponseSchema(todoItemSchema),
+})

package/src/modules/customers/api/people/[id]/route.ts

@@ -23,6 +23,7 @@ import { E } from '#generated/entities.ids.generated'
 import { mergePersonCustomFieldValues, resolvePersonCustomFieldRouting } from '../../../lib/customFieldRouting'
 import {
   CUSTOMER_INTERACTION_ACTIVITY_ADAPTER_SOURCE,
+  EXAMPLE_TODO_SOURCE,
   CUSTOMER_INTERACTION_TODO_ADAPTER_SOURCE,
   mapInteractionRecordToActivitySummary,
   mapInteractionRecordToTodoSummary,
@@ -235,7 +236,7 @@ async function resolveTodoDetails(
 
   const idsBySource = new Map<string, Set<string>>()
   for (const link of links) {
-    const source = typeof link.todoSource === 'string' && link.todoSource.trim().length > 0 ? link.todoSource : 'example:todo'
+    const source = typeof link.todoSource === 'string' && link.todoSource.trim().length > 0 ? link.todoSource : EXAMPLE_TODO_SOURCE
     const id = typeof link.todoId === 'string' && link.todoId.trim().length > 0 ? link.todoId : String(link.todoId ?? '')
     if (!id) continue
     if (!idsBySource.has(source)) idsBySource.set(source, new Set<string>())
@@ -775,7 +776,7 @@ export async function GET(_req: Request, ctx: { params?: { id?: string } }) {
                   ...todoLinks
                     .filter((link) => !canonicalTodoBridgeIds.has(link.todoId))
                     .map((link) => {
-                      const source = typeof link.todoSource === 'string' && link.todoSource.trim().length > 0 ? link.todoSource : 'example:todo'
+                      const source = typeof link.todoSource === 'string' && link.todoSource.trim().length > 0 ? link.todoSource : EXAMPLE_TODO_SOURCE
                       const key = `${source}:${link.todoId}`
                       const detail = todoDetails.get(key)
                       return {

package/src/modules/customers/api/todos/route.ts

@@ -22,17 +22,16 @@ import { todoLinkWithTodoCreateSchema } from '../../data/validators'
 import { resolveCustomerInteractionFeatureFlags } from '../../lib/interactionFeatureFlags'
 import { resolveCustomersRequestContext } from '../../lib/interactionRequestContext'
 import {
-  hydrateCanonicalInteractions,
-  loadCustomerSummaries,
-} from '../../lib/interactionReadModel'
-import {
+  EXAMPLE_TODO_SOURCE,
   CUSTOMER_INTERACTION_TODO_ADAPTER_SOURCE,
-  CUSTOMER_INTERACTION_TASK_SOURCE,
 } from '../../lib/interactionCompatibility'
 import {
-  type CustomerTodoRow,
-  mapInteractionRecordToTodoRow,
-  mapLegacyTodoLinkToRow,
+  filterTodoRows,
+  listCanonicalTodoRows,
+  listLegacyTodoRows,
+  normalizeTodoSearch,
+  paginateTodoRows,
+  sortTodoRows,
   resolveLegacyTodoDetails,
 } from '../../lib/todoCompatibility'
 
@@ -79,11 +78,6 @@ const DEPRECATION_HEADERS = {
   Link: '</api/customers/interactions>; rel="successor-version"',
 }
 
-type CanonicalTodoListResult = {
-  items: CustomerTodoRow[]
-  bridgeIds: Set<string>
-}
-
 function resolveGuardUserId(auth: {
   sub?: string | null
   userId?: string | null
@@ -118,64 +112,6 @@ async function legacyAdaptersDisabledResponse(): Promise<Response> {
   ))
 }
 
-function normalizeSearch(value: string | undefined): string | null {
-  if (typeof value !== 'string') return null
-  const trimmed = value.trim().toLowerCase()
-  return trimmed.length > 0 ? trimmed : null
-}
-
-function sortTodoRows(rows: CustomerTodoRow[]): CustomerTodoRow[] {
-  return [...rows].sort((left, right) => {
-    const leftTime = new Date(left.createdAt).getTime()
-    const rightTime = new Date(right.createdAt).getTime()
-    if (leftTime === rightTime) {
-      return right.id.localeCompare(left.id)
-    }
-    return rightTime - leftTime
-  })
-}
-
-function filterTodoRows(rows: CustomerTodoRow[], search: string | null): CustomerTodoRow[] {
-  if (!search) return rows
-  return rows.filter((row) => {
-    const haystack = [
-      row.customer.displayName,
-      row.todoTitle,
-      row.todoDescription,
-    ]
-      .filter((value): value is string => typeof value === 'string' && value.trim().length > 0)
-      .join(' ')
-      .toLowerCase()
-    return haystack.includes(search)
-  })
-}
-
-function paginateTodoRows(
-  rows: CustomerTodoRow[],
-  page: number,
-  pageSize: number,
-  exportAll: boolean,
-): { items: CustomerTodoRow[]; total: number; page: number; pageSize: number; totalPages: number } {
-  const total = rows.length
-  if (exportAll) {
-    return {
-      items: rows,
-      total,
-      page: 1,
-      pageSize: total,
-      totalPages: 1,
-    }
-  }
-  const start = (page - 1) * pageSize
-  return {
-    items: rows.slice(start, start + pageSize),
-    total,
-    page,
-    pageSize,
-    totalPages: Math.max(1, Math.ceil(total / pageSize)),
-  }
-}
-
 function normalizeTodoStatusInput(body: z.infer<typeof todoUpdateBodySchema>): boolean | undefined {
   if (typeof body.isDone === 'boolean') return body.isDone
   if (typeof body.is_done === 'boolean') return body.is_done
@@ -198,110 +134,6 @@ function collectTodoCustomValues(
   return Object.keys(direct).length > 0 ? direct : undefined
 }
 
-async function listLegacyTodoRows(
-  em: EntityManager,
-  queryEngine: QueryEngine,
-  tenantId: string,
-  organizationIds: string[] | null,
-  entityId: string | undefined,
-): Promise<CustomerTodoRow[]> {
-  const where: Record<string, unknown> = { tenantId }
-  if (organizationIds && organizationIds.length > 0) {
-    where.organizationId = { $in: organizationIds }
-  }
-  if (entityId) {
-    where.entity = entityId
-  }
-
-  const links = await em.find(CustomerTodoLink, where, {
-    populate: ['entity'],
-    orderBy: { createdAt: 'desc' },
-  })
-  const details = await resolveLegacyTodoDetails(
-    queryEngine,
-    links,
-    tenantId,
-    organizationIds ?? [],
-  )
-
-  return links.map((link) => {
-    const source =
-      typeof link.todoSource === 'string' && link.todoSource.trim().length > 0
-        ? link.todoSource
-        : 'example:todo'
-    return mapLegacyTodoLinkToRow(
-      link,
-      details.get(`${source}:${link.todoId}`) ?? null,
-    )
-  })
-}
-
-async function listCanonicalTodoRows(
-  em: EntityManager,
-  queryEngine: QueryEngine,
-  container: { resolve: (name: string) => unknown },
-  auth: { tenantId: string | null; orgId: string | null; sub?: string | null; userId?: string | null; keyId?: string | null },
-  selectedOrganizationId: string | null,
-  organizationIds: string[] | null,
-  query: z.infer<typeof querySchema>,
-  options?: { includeDeleted?: boolean; source?: string | string[] | null },
-): Promise<CanonicalTodoListResult> {
-  const where: Record<string, unknown> = {
-    tenantId: auth.tenantId,
-    interactionType: 'task',
-  }
-  if (!options?.includeDeleted) {
-    where.deletedAt = null
-  }
-  if (organizationIds && organizationIds.length > 0) {
-    where.organizationId = { $in: organizationIds }
-  }
-  if (query.entityId) {
-    where.entity = query.entityId
-  }
-  if (options?.source) {
-    where.source = Array.isArray(options.source) ? { $in: options.source } : options.source
-  }
-
-  const interactions = await em.find(CustomerInteraction, where, {
-    orderBy: { createdAt: 'desc' },
-  })
-  const activeInteractions = interactions.filter((interaction) => !interaction.deletedAt)
-  const hydrated = await hydrateCanonicalInteractions({
-    em,
-    container,
-    auth,
-    selectedOrganizationId,
-    interactions: activeInteractions,
-  })
-  const customerIds = Array.from(
-    new Set(
-      hydrated
-        .map((interaction) => interaction.entityId ?? null)
-        .filter((value): value is string => !!value),
-    ),
-  )
-  const customerSummaries = await loadCustomerSummaries(em, customerIds, auth.tenantId, selectedOrganizationId)
-
-  const items = hydrated.map((interaction) =>
-    mapInteractionRecordToTodoRow(
-      interaction,
-      interaction.entityId ? customerSummaries.get(interaction.entityId) ?? null : null,
-      {
-        todoSource:
-          interaction.source === CUSTOMER_INTERACTION_TODO_ADAPTER_SOURCE
-            ? CUSTOMER_INTERACTION_TASK_SOURCE
-            : CUSTOMER_INTERACTION_TASK_SOURCE,
-      },
-    ),
-  )
-
-  return {
-    items,
-    bridgeIds: new Set(interactions.map((interaction) => interaction.id)),
-  }
-}
-
 async function findLegacyTodoLink(
   em: EntityManager,
   target: { linkId?: string; todoId?: string },
@@ -335,7 +167,7 @@ async function ensureCanonicalTodoBridge(
   const source =
     typeof link.todoSource === 'string' && link.todoSource.trim().length > 0
       ? link.todoSource
-      : 'example:todo'
+      : EXAMPLE_TODO_SOURCE
   const detail = detailMap.get(`${source}:${link.todoId}`) ?? null
   const entityId = typeof link.entity === 'string' ? link.entity : link.entity.id
 
@@ -396,29 +228,27 @@ export async function GET(request: Request): Promise<Response> {
     }
     const queryEngine = container.resolve('queryEngine') as QueryEngine
     const exportAll = parseBooleanToken(query.all) === true
-    const search = normalizeSearch(query.search)
+    const search = normalizeTodoSearch(query.search)
 
     const mergedRows = flags.unified
       ? (await listCanonicalTodoRows(
           em,
-          queryEngine,
           container,
           auth,
           selectedOrganizationId,
           organizationIds,
-          query,
+          { entityId: query.entityId },
         )).items
       : await Promise.all([
         listLegacyTodoRows(em, queryEngine, auth.tenantId, organizationIds, query.entityId),
         listCanonicalTodoRows(
           em,
-          queryEngine,
           container,
           auth,
           selectedOrganizationId,
           organizationIds,
-          query,
           {
+            entityId: query.entityId,
             includeDeleted: true,
             source: CUSTOMER_INTERACTION_TODO_ADAPTER_SOURCE,
           },
@@ -732,6 +562,8 @@ const todoItemSchema = z.object({
   organizationId: z.string(),
   tenantId: z.string(),
   createdAt: z.string(),
+  externalHref: z.string().nullable().optional(),
+  _integrations: z.record(z.string(), z.unknown()).optional(),
   customer: z.object({
     id: z.string().nullable(),
     displayName: z.string().nullable(),

package/src/modules/customers/backend/customer-tasks/page.meta.ts

@@ -0,0 +1,23 @@
+import React from 'react'
+
+const tasksIcon = React.createElement(
+  'svg',
+  { width: 16, height: 16, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 2 },
+  React.createElement('rect', { x: 9, y: 3, width: 6, height: 4, rx: 1 }),
+  React.createElement('path', { d: 'M9 5H7a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2h-2' }),
+  React.createElement('path', { d: 'M9 12h6' }),
+  React.createElement('path', { d: 'M9 16h4' }),
+)
+
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['customers.interactions.view'],
+  pageTitle: 'Customer related tasks',
+  pageTitleKey: 'customers.workPlan.customerTodos.page.title',
+  pageGroup: 'Customers',
+  pageGroupKey: 'customers.nav.group',
+  pagePriority: 10,
+  pageOrder: 120,
+  icon: tasksIcon,
+  breadcrumb: [{ label: 'Customer related tasks', labelKey: 'customers.workPlan.customerTodos.page.title' }],
+}

package/src/modules/customers/backend/customer-tasks/page.tsx

@@ -0,0 +1,12 @@
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { CustomerTodosTable } from '../../components/CustomerTodosTable'
+
+export default function CustomerTasksPage() {
+  return (
+    <Page>
+      <PageBody>
+        <CustomerTodosTable />
+      </PageBody>
+    </Page>
+  )
+}