@open-mercato/core 0.6.6-develop.6089.1.a7ed560528 → 0.6.6-develop.6121.1.5797a901b3

package/src/modules/catalog/migrations/.snapshot-open-mercato.json

@@ -2701,6 +2701,38 @@
           "enumItems": [],
           "mappedType": "text"
         },
+        "gtin_type": {
+          "name": "gtin_type",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "hs_code": {
+          "name": "hs_code",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
         "created_at": {
           "name": "created_at",
           "type": "timestamptz(6)",
@@ -3088,6 +3120,15 @@
           "keyName": "catalog_product_variants_sku_unique",
           "primary": false,
           "unique": true
+        },
+        {
+          "keyName": "catalog_product_variants_gtin_scope_unique",
+          "columnNames": [],
+          "composite": false,
+          "constraint": false,
+          "primary": false,
+          "unique": false,
+          "expression": "create unique index \"catalog_product_variants_gtin_scope_unique\" on \"catalog_product_variants\" (\"tenant_id\", \"organization_id\", \"gtin_type\", \"barcode\") where deleted_at is null and gtin_type is not null and barcode is not null"
         }
       ],
       "checks": [],
@@ -3334,6 +3375,422 @@
           "enumItems": [],
           "mappedType": "boolean"
         },
+        "country_of_origin_code": {
+          "name": "country_of_origin_code",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "pkwiu_code": {
+          "name": "pkwiu_code",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "cn_code": {
+          "name": "cn_code",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "hs_code": {
+          "name": "hs_code",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "tax_classification_code": {
+          "name": "tax_classification_code",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "gtu_codes": {
+          "name": "gtu_codes",
+          "type": "text[]",
+          "mappedType": "array",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "age_min": {
+          "name": "age_min",
+          "type": "smallint",
+          "mappedType": "smallint",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "is_excise_good": {
+          "name": "is_excise_good",
+          "type": "boolean",
+          "mappedType": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "false",
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "excise_category": {
+          "name": "excise_category",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "requires_prescription": {
+          "name": "requires_prescription",
+          "type": "boolean",
+          "mappedType": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "false",
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "hazmat_class": {
+          "name": "hazmat_class",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "un_number": {
+          "name": "un_number",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "hazmat_packing_group": {
+          "name": "hazmat_packing_group",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "contains_lithium_battery": {
+          "name": "contains_lithium_battery",
+          "type": "boolean",
+          "mappedType": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "false",
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "launch_at": {
+          "name": "launch_at",
+          "type": "timestamptz(6)",
+          "mappedType": "datetime",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "end_of_life_at": {
+          "name": "end_of_life_at",
+          "type": "timestamptz(6)",
+          "mappedType": "datetime",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "available_from": {
+          "name": "available_from",
+          "type": "timestamptz(6)",
+          "mappedType": "datetime",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "available_until": {
+          "name": "available_until",
+          "type": "timestamptz(6)",
+          "mappedType": "datetime",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "min_order_qty": {
+          "name": "min_order_qty",
+          "type": "int",
+          "mappedType": "integer",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "max_order_qty": {
+          "name": "max_order_qty",
+          "type": "int",
+          "mappedType": "integer",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "order_qty_increment": {
+          "name": "order_qty_increment",
+          "type": "int",
+          "mappedType": "integer",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "requires_shipping": {
+          "name": "requires_shipping",
+          "type": "boolean",
+          "mappedType": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "true",
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "is_quote_only": {
+          "name": "is_quote_only",
+          "type": "boolean",
+          "mappedType": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "false",
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "seo_title": {
+          "name": "seo_title",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "seo_description": {
+          "name": "seo_description",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
+        "canonical_url": {
+          "name": "canonical_url",
+          "type": "text",
+          "mappedType": "text",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "unique": false,
+          "enumItems": [],
+          "comment": null
+        },
         "metadata": {
           "name": "metadata",
           "type": "jsonb",

package/src/modules/catalog/migrations/Migration20260611090000.ts

@@ -0,0 +1,17 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260611090000 extends Migration {
+
+  override async up(): Promise<void> {
+    this.addSql(`alter table "catalog_products" add column if not exists "country_of_origin_code" text null, add column if not exists "pkwiu_code" text null, add column if not exists "cn_code" text null, add column if not exists "hs_code" text null, add column if not exists "tax_classification_code" text null, add column if not exists "gtu_codes" text[] null, add column if not exists "age_min" smallint null, add column if not exists "is_excise_good" boolean not null default false, add column if not exists "excise_category" text null, add column if not exists "requires_prescription" boolean not null default false, add column if not exists "hazmat_class" text null, add column if not exists "un_number" text null, add column if not exists "hazmat_packing_group" text null, add column if not exists "contains_lithium_battery" boolean not null default false, add column if not exists "launch_at" timestamptz null, add column if not exists "end_of_life_at" timestamptz null, add column if not exists "available_from" timestamptz null, add column if not exists "available_until" timestamptz null, add column if not exists "min_order_qty" int null, add column if not exists "max_order_qty" int null, add column if not exists "order_qty_increment" int null, add column if not exists "requires_shipping" boolean not null default true, add column if not exists "is_quote_only" boolean not null default false, add column if not exists "seo_title" text null, add column if not exists "seo_description" text null, add column if not exists "canonical_url" text null;`);
+    this.addSql(`alter table "catalog_product_variants" add column if not exists "gtin_type" text null, add column if not exists "hs_code" text null;`);
+    this.addSql(`create unique index "catalog_product_variants_gtin_scope_unique" on "catalog_product_variants" ("tenant_id", "organization_id", "gtin_type", "barcode") where deleted_at is null and gtin_type is not null and barcode is not null;`);
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`drop index if exists "catalog_product_variants_gtin_scope_unique";`);
+    this.addSql(`alter table "catalog_product_variants" drop column if exists "gtin_type", drop column if exists "hs_code";`);
+    this.addSql(`alter table "catalog_products" drop column if exists "country_of_origin_code", drop column if exists "pkwiu_code", drop column if exists "cn_code", drop column if exists "hs_code", drop column if exists "tax_classification_code", drop column if exists "gtu_codes", drop column if exists "age_min", drop column if exists "is_excise_good", drop column if exists "excise_category", drop column if exists "requires_prescription", drop column if exists "hazmat_class", drop column if exists "un_number", drop column if exists "hazmat_packing_group", drop column if exists "contains_lithium_battery", drop column if exists "launch_at", drop column if exists "end_of_life_at", drop column if exists "available_from", drop column if exists "available_until", drop column if exists "min_order_qty", drop column if exists "max_order_qty", drop column if exists "order_qty_increment", drop column if exists "requires_shipping", drop column if exists "is_quote_only", drop column if exists "seo_title", drop column if exists "seo_description", drop column if exists "canonical_url";`);
+  }
+
+}

package/src/modules/catalog/translations.ts

@@ -1,5 +1,5 @@
 export const translatableFields: Record<string, string[]> = {
-  'catalog:catalog_product': ['title', 'subtitle', 'description'],
+  'catalog:catalog_product': ['title', 'subtitle', 'description', 'seoTitle', 'seoDescription'],
   'catalog:catalog_product_variant': ['name'],
   'catalog:catalog_offer': ['title', 'subtitle', 'description'],
   'catalog:catalog_option_schema_template': ['name', 'description'],

package/src/modules/configs/api/cache/route.ts

@@ -5,6 +5,11 @@ import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { runWithCacheTenant, type CacheStrategy } from '@open-mercato/cache'
 import { collectCrudCacheStats, purgeCrudCacheSegment } from '@open-mercato/shared/lib/crud/cache-stats'
+import {
+  bridgeLegacyGuard,
+  runMutationGuards,
+  type MutationGuardInput,
+} from '@open-mercato/shared/lib/crud/mutation-guard-registry'
 import {
   configsTag,
   cacheStatsResponseSchema,
@@ -19,6 +24,11 @@ export const metadata = {
   POST: { requireAuth: true, requireFeatures: ['configs.cache.manage'] },
 } as const
 
+function resolveUserFeatures(auth: unknown): string[] {
+  const features = (auth as { features?: unknown } | null)?.features
+  return Array.isArray(features) ? features.filter((value): value is string => typeof value === 'string') : []
+}
+
 export async function GET(req: Request) {
   const auth = await getAuthFromRequest(req)
   if (!auth?.sub) {
@@ -79,22 +89,74 @@ export async function POST(req: Request) {
     }
     const tenantScope = auth.tenantId ?? null
 
-    if (action === 'purgeSegment') {
-      const segment = typeof body?.segment === 'string' ? body.segment.trim() : ''
-      if (!segment) {
+    const segment =
+      action === 'purgeSegment'
+        ? (typeof body?.segment === 'string' ? body.segment.trim() : '')
+        : null
+    if (action === 'purgeSegment' && !segment) {
+      return NextResponse.json(
+        { error: translate('configs.cache.purgeError', 'Failed to purge cache segment.') },
+        { status: 400 },
+      )
+    }
+
+    // Mutation-guard contract for this custom write route (packages/core/AGENTS.md
+    // → API Routes). A cache purge carries no per-record optimistic-lock version, so
+    // the default OSS guard short-circuits; wiring it keeps the route on the shared
+    // write-guard interception path for any tenant-registered guard.
+    const guardInput: MutationGuardInput = {
+      tenantId: tenantScope ?? '',
+      organizationId: auth.orgId ?? null,
+      userId: auth.sub,
+      resourceKind: 'configs.cache',
+      resourceId: segment ?? tenantScope ?? 'all',
+      operation: 'delete',
+      requestMethod: req.method,
+      requestHeaders: req.headers,
+      mutationPayload: { action, ...(segment ? { segment } : {}) },
+    }
+    const guard = bridgeLegacyGuard(container)
+    let afterSuccessCallbacks: Awaited<ReturnType<typeof runMutationGuards>>['afterSuccessCallbacks'] = []
+    if (guard) {
+      const guardResult = await runMutationGuards([guard], guardInput, {
+        userFeatures: resolveUserFeatures(auth),
+      })
+      if (!guardResult.ok) {
         return NextResponse.json(
-          { error: translate('configs.cache.purgeError', 'Failed to purge cache segment.') },
-          { status: 400 },
+          guardResult.errorBody ?? { error: translate('configs.cache.purgeError', 'Failed to purge cache segment.') },
+          { status: guardResult.errorStatus ?? 422 },
         )
       }
-      const result = await runWithCacheTenant(tenantScope, () => purgeCrudCacheSegment(cache, segment))
+      afterSuccessCallbacks = guardResult.afterSuccessCallbacks
+    }
+
+    let responseBody: Record<string, unknown>
+    if (action === 'purgeSegment') {
+      const result = await runWithCacheTenant(tenantScope, () => purgeCrudCacheSegment(cache, segment!))
       const stats = await runWithCacheTenant(tenantScope, () => collectCrudCacheStats(cache))
-      return NextResponse.json({ action: 'purgeSegment', segment, deleted: result.deleted, stats })
+      responseBody = { action: 'purgeSegment', segment, deleted: result.deleted, stats }
+    } else {
+      await runWithCacheTenant(tenantScope, () => cache.clear())
+      const stats = await runWithCacheTenant(tenantScope, () => collectCrudCacheStats(cache))
+      responseBody = { action: 'purgeAll', stats }
+    }
+
+    for (const callback of afterSuccessCallbacks) {
+      if (!callback.guard.afterSuccess) continue
+      await callback.guard.afterSuccess({
+        tenantId: tenantScope ?? '',
+        organizationId: auth.orgId ?? null,
+        userId: auth.sub,
+        resourceKind: 'configs.cache',
+        resourceId: segment ?? tenantScope ?? 'all',
+        operation: 'delete',
+        requestMethod: req.method,
+        requestHeaders: req.headers,
+        metadata: callback.metadata ?? null,
+      })
     }
 
-    await runWithCacheTenant(tenantScope, () => cache.clear())
-    const stats = await runWithCacheTenant(tenantScope, () => collectCrudCacheStats(cache))
-    return NextResponse.json({ action: 'purgeAll', stats })
+    return NextResponse.json(responseBody)
   } catch (error) {
     console.error('[configs.cache] failed to purge cache', error)
     return NextResponse.json(