create-mercato-app 0.4.6-develop-af28b566dd → 0.4.6-develop-4d77832982

package/template/src/modules/example/api/customer-priorities/route.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod'
+import { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'
+import { invalidateCrudCache } from '@open-mercato/shared/lib/crud/cache'
+import { E } from '@/.mercato/generated/entities.ids.generated'
+import { id, customer_id, priority, organization_id, tenant_id, created_at } from '@/.mercato/generated/entities/example_customer_priority'
+import { ExampleCustomerPriority } from '../../data/entities'
+import {
+  customerPriorityCreateSchema,
+  customerPriorityListSchema,
+  customerPriorityUpdateSchema,
+} from '../../data/validators'
+import {
+  createExampleCrudOpenApi,
+  createExamplePagedListResponseSchema,
+  exampleOkSchema,
+} from '../openapi'
+
+type PriorityListQuery = z.infer<typeof customerPriorityListSchema>
+
+const customerPriorityListItemSchema = z.object({
+  id: z.string().uuid(),
+  customer_id: z.string().uuid(),
+  priority: z.enum(['low', 'normal', 'high', 'critical']),
+  tenant_id: z.string().uuid().nullable().optional(),
+  organization_id: z.string().uuid().nullable().optional(),
+})
+
+const customerPriorityCreateResponseSchema = z.object({
+  id: z.string().uuid(),
+})
+
+export const { metadata, GET, POST, PUT, DELETE } = makeCrudRoute({
+  metadata: {
+    GET: { requireAuth: true, requireFeatures: ['example.view'] },
+    POST: { requireAuth: true, requireFeatures: ['example.todos.manage'] },
+    PUT: { requireAuth: true, requireFeatures: ['example.todos.manage'] },
+    DELETE: { requireAuth: true, requireFeatures: ['example.todos.manage'] },
+  },
+  orm: {
+    entity: ExampleCustomerPriority,
+    idField: 'id',
+    orgField: 'organizationId',
+    tenantField: 'tenantId',
+    softDeleteField: 'deletedAt',
+  },
+  indexer: { entityType: E.example.example_customer_priority },
+  list: {
+    schema: customerPriorityListSchema,
+    entityId: E.example.example_customer_priority,
+    fields: [id, customer_id, priority, organization_id, tenant_id, created_at],
+    sortFieldMap: {
+      id,
+      customer_id,
+      priority,
+      created_at,
+    },
+    buildFilters: async (query: PriorityListQuery) => {
+      const filters: Record<string, unknown> = {}
+      if (query.id) filters.id = query.id
+      if (query.customerId) filters.customer_id = query.customerId
+      return filters
+    },
+  },
+  create: {
+    schema: customerPriorityCreateSchema,
+    mapToEntity: (input) => ({
+      customerId: input.customerId,
+      priority: input.priority,
+    }),
+    response: (entity) => ({ id: String(entity.id) }),
+  },
+  update: {
+    schema: customerPriorityUpdateSchema,
+    getId: (input) => input.id,
+    applyToEntity: (entity, input) => {
+      if (input.customerId) entity.customerId = input.customerId
+      if (input.priority) entity.priority = input.priority
+    },
+    response: () => ({ ok: true }),
+  },
+  del: {
+    idFrom: 'body',
+    softDelete: true,
+    response: () => ({ ok: true }),
+  },
+  hooks: {
+    afterCreate: async (entity, ctx) => {
+      if (!ctx.auth) return
+      await invalidateCrudCache(
+        ctx.container,
+        'customers.person',
+        {
+          id: entity.customerId,
+          organizationId: ctx.selectedOrganizationId ?? ctx.auth.orgId ?? null,
+          tenantId: ctx.auth.tenantId ?? null,
+        },
+        ctx.auth.tenantId ?? null,
+        'example.customer-priority.create',
+        ['customers.customer_entity', 'customers.people'],
+      )
+    },
+    afterUpdate: async (entity, ctx) => {
+      if (!ctx.auth) return
+      await invalidateCrudCache(
+        ctx.container,
+        'customers.person',
+        {
+          id: entity.customerId,
+          organizationId: ctx.selectedOrganizationId ?? ctx.auth.orgId ?? null,
+          tenantId: ctx.auth.tenantId ?? null,
+        },
+        ctx.auth.tenantId ?? null,
+        'example.customer-priority.update',
+        ['customers.customer_entity', 'customers.people'],
+      )
+    },
+    afterDelete: async (_id, ctx) => {
+      if (!ctx.auth) return
+      await invalidateCrudCache(
+        ctx.container,
+        'customers.person',
+        {
+          organizationId: ctx.selectedOrganizationId ?? ctx.auth.orgId ?? null,
+          tenantId: ctx.auth.tenantId ?? null,
+        },
+        ctx.auth.tenantId ?? null,
+        'example.customer-priority.delete',
+        ['customers.customer_entity', 'customers.people'],
+      )
+    },
+  },
+})
+
+export const openApi = createExampleCrudOpenApi({
+  resourceName: 'Customer Priority',
+  pluralName: 'Customer Priorities',
+  querySchema: customerPriorityListSchema,
+  listResponseSchema: createExamplePagedListResponseSchema(customerPriorityListItemSchema),
+  create: {
+    schema: customerPriorityCreateSchema,
+    responseSchema: customerPriorityCreateResponseSchema,
+    description: 'Creates or stores customer priority records for injected CRUD fields.',
+  },
+  update: {
+    schema: customerPriorityUpdateSchema,
+    responseSchema: exampleOkSchema,
+    description: 'Updates customer priority values.',
+  },
+  del: {
+    schema: z.object({ id: z.string().uuid() }),
+    responseSchema: exampleOkSchema,
+    description: 'Soft-deletes a customer priority record.',
+  },
+})

package/template/src/modules/example/api/interceptors.ts

@@ -0,0 +1,174 @@
+import type { ApiInterceptor } from '@open-mercato/shared/lib/crud/api-interceptor'
+import { ExampleCustomerPriority } from '../data/entities'
+
+type UnknownRecord = Record<string, unknown>
+
+function readString(value: unknown): string | null {
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+export const interceptors: ApiInterceptor[] = [
+  {
+    id: 'example.block-test-todos',
+    targetRoute: 'example/todos',
+    methods: ['POST', 'PUT'],
+    priority: 100,
+    async before(request) {
+      const title = request.body?.title
+      if (typeof title === 'string' && title.includes('BLOCKED')) {
+        return {
+          ok: false,
+          statusCode: 422,
+          message: 'Todo titles containing "BLOCKED" are blocked by interceptor.',
+        }
+      }
+      return { ok: true }
+    },
+  },
+  {
+    id: 'example.todos-probe-timeout',
+    targetRoute: 'example/todos',
+    methods: ['GET'],
+    priority: 90,
+    timeoutMs: 100,
+    async before(request) {
+      const probe = readString(request.query?.interceptorProbe)
+      if (probe !== 'timeout') return { ok: true }
+      await new Promise((resolve) => setTimeout(resolve, 200))
+      return { ok: true }
+    },
+  },
+  {
+    id: 'example.todos-probe-crash',
+    targetRoute: 'example/todos',
+    methods: ['GET'],
+    priority: 89,
+    async before(request) {
+      const probe = readString(request.query?.interceptorProbe)
+      if (probe !== 'crash') return { ok: true }
+      throw new Error('Interceptor crash probe')
+    },
+  },
+  {
+    id: 'example.todos-probe-bad-query',
+    targetRoute: 'example/todos',
+    methods: ['GET'],
+    priority: 88,
+    async before(request) {
+      const probe = readString(request.query?.interceptorProbe)
+      if (probe !== 'bad-query') return { ok: true }
+      return {
+        ok: true,
+        query: {
+          ...(request.query ?? {}),
+          interceptorProbe: undefined,
+          page: 'not-a-number',
+        },
+      }
+    },
+  },
+  {
+    id: 'example.wildcard-probe',
+    targetRoute: 'example/*',
+    methods: ['GET'],
+    priority: 60,
+    async before(request) {
+      const probe = readString(request.query?.interceptorProbe)
+      if (probe !== 'wildcard') return { ok: true }
+      return {
+        ok: true,
+        metadata: { wildcardProbe: true },
+      }
+    },
+    async after(_request, response, context) {
+      if (!context.metadata?.wildcardProbe) return {}
+      return {
+        merge: {
+          _example: {
+            ...((response.body._example as Record<string, unknown> | undefined) ?? {}),
+            wildcardProbe: true,
+          },
+        },
+      }
+    },
+  },
+  {
+    id: 'example.todos-response-meta',
+    targetRoute: 'example/todos',
+    methods: ['GET'],
+    priority: 10,
+    async before() {
+      return {
+        ok: true,
+        metadata: { startedAt: Date.now() },
+      }
+    },
+    async after(_request, response, context) {
+      return {
+        merge: {
+          _example: {
+            ...((response.body._example as Record<string, unknown> | undefined) ?? {}),
+            interceptor: {
+              processedAt: new Date().toISOString(),
+              processingTimeMs: Math.max(0, Date.now() - Number(context.metadata?.startedAt ?? Date.now())),
+            },
+          },
+        },
+      }
+    },
+  },
+  {
+    id: 'example.customer-priority-filter',
+    targetRoute: 'customers/people',
+    methods: ['GET'],
+    priority: 70,
+    async before(request) {
+      const priority = readString(request.query?.examplePriority)
+      if (!priority) return { ok: true }
+      return {
+        ok: true,
+        query: {
+          ...(request.query ?? {}),
+          examplePriority: undefined,
+        },
+        metadata: {
+          examplePriority: priority,
+        },
+      }
+    },
+    async after(_request, response, context) {
+      const priority = readString(context.metadata?.examplePriority)
+      if (!priority) return {}
+      const responseBody = response.body as UnknownRecord
+      const items = Array.isArray(responseBody.items)
+        ? responseBody.items
+        : (Array.isArray(responseBody.data) ? responseBody.data : [])
+      if (items.length === 0) return {}
+      const customerIds = items
+        .map((item) => (item && typeof item === 'object' ? readString((item as UnknownRecord).id) : null))
+        .filter((id): id is string => typeof id === 'string' && id.length > 0)
+      if (customerIds.length === 0) return {}
+
+      const matches = await context.em.find(ExampleCustomerPriority, {
+        customerId: { $in: customerIds },
+        priority: priority as ExampleCustomerPriority['priority'],
+        organizationId: context.organizationId,
+        tenantId: context.tenantId,
+        deletedAt: null,
+      }, { fields: ['customerId'] })
+      const matchedIds = new Set(matches.map((entry) => entry.customerId))
+      const filtered = items.filter((item) => {
+        if (!item || typeof item !== 'object') return false
+        const id = readString((item as UnknownRecord).id)
+        return id ? matchedIds.has(id) : false
+      })
+      return {
+        replace: {
+          ...responseBody,
+          items: filtered,
+          total: filtered.length,
+        },
+      }
+    },
+  },
+]

package/template/src/modules/example/api/todos/route.ts

@@ -34,7 +34,7 @@ const querySchema = z
     organizationId: z.string().uuid().optional(),
     createdFrom: z.string().optional(),
     createdTo: z.string().optional(),
-    format: z.enum(['json', 'csv']).optional().default('json'),
+    format: z.enum(['json', 'csv']).optional(),
   })
   .passthrough()
 

package/template/src/modules/example/backend/umes-extensions/page.meta.ts

@@ -0,0 +1,24 @@
+import React from 'react'
+
+const puzzleIcon = React.createElement(
+  'svg',
+  { width: 16, height: 16, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 2 },
+  React.createElement('path', { d: 'M12 2v6m0 0a2 2 0 1 0 0 4m0-4a2 2 0 1 1 0-4m0 8v6m0-6a2 2 0 1 0 0 4m0-4a2 2 0 1 1 0-4M2 12h6m0 0a2 2 0 1 0 4 0m-4 0a2 2 0 1 1-4 0m8 0h6m-6 0a2 2 0 1 0 4 0m-4 0a2 2 0 1 1 4 0' }),
+)
+
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['example.todos.view'],
+  pageTitle: 'Phase E-H handlers',
+  pageTitleKey: 'example.menu.umesExtensions',
+  pageGroup: 'Example',
+  pageGroupKey: 'example.nav.group',
+  pageOrder: 20600,
+  icon: puzzleIcon,
+  breadcrumb: [
+    { label: 'General tasks', labelKey: 'example.todos.page.title', href: '/backend/todos' },
+    { label: 'Phase E-H extensions', labelKey: 'example.umes.extensions.title' },
+  ],
+}
+
+export default metadata