@open-mercato/core 0.8.1-develop.7296.1.2111d779db → 0.9.0

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

@@ -0,0 +1,375 @@
+{
+  "name": "public",
+  "namespaces": [
+    "public"
+  ],
+  "tables": [
+    {
+      "name": "availability_policies",
+      "schema": "public",
+      "columns": {
+        "allow_backorder": {
+          "name": "allow_backorder",
+          "type": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "false",
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "boolean"
+        },
+        "backorder_lead_time_days": {
+          "name": "backorder_lead_time_days",
+          "type": "int",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "integer"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamptz(6)",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "unique": false,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "datetime"
+        },
+        "deleted_at": {
+          "name": "deleted_at",
+          "type": "timestamptz(6)",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "datetime"
+        },
+        "hide_when_out_of_stock": {
+          "name": "hide_when_out_of_stock",
+          "type": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "false",
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "boolean"
+        },
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": true,
+          "nullable": false,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "gen_random_uuid()",
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "uuid"
+        },
+        "is_active": {
+          "name": "is_active",
+          "type": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": "true",
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "boolean"
+        },
+        "is_stock_managed": {
+          "name": "is_stock_managed",
+          "type": "boolean",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "boolean"
+        },
+        "low_stock_threshold": {
+          "name": "low_stock_threshold",
+          "type": "int",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "integer"
+        },
+        "max_order_quantity": {
+          "name": "max_order_quantity",
+          "type": "int",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "integer"
+        },
+        "min_order_quantity": {
+          "name": "min_order_quantity",
+          "type": "int",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "integer"
+        },
+        "organization_id": {
+          "name": "organization_id",
+          "type": "uuid",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "uuid"
+        },
+        "preorder_release_at": {
+          "name": "preorder_release_at",
+          "type": "timestamptz(6)",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "datetime"
+        },
+        "product_id": {
+          "name": "product_id",
+          "type": "uuid",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "uuid"
+        },
+        "quantity_increment": {
+          "name": "quantity_increment",
+          "type": "int",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "integer"
+        },
+        "store_id": {
+          "name": "store_id",
+          "type": "uuid",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "uuid"
+        },
+        "tenant_id": {
+          "name": "tenant_id",
+          "type": "uuid",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "uuid"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamptz(6)",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": false,
+          "unique": false,
+          "length": 6,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "datetime"
+        },
+        "variant_id": {
+          "name": "variant_id",
+          "type": "uuid",
+          "unsigned": false,
+          "autoincrement": false,
+          "primary": false,
+          "nullable": true,
+          "unique": false,
+          "length": null,
+          "precision": null,
+          "scale": null,
+          "default": null,
+          "comment": null,
+          "collation": null,
+          "enumItems": [],
+          "mappedType": "uuid"
+        }
+      },
+      "indexes": [
+        {
+          "columnNames": [
+            "id"
+          ],
+          "composite": false,
+          "constraint": true,
+          "keyName": "availability_policies_pkey",
+          "primary": true,
+          "unique": true
+        },
+        {
+          "columnNames": [
+            "tenant_id",
+            "organization_id"
+          ],
+          "composite": true,
+          "constraint": false,
+          "keyName": "availability_policies_scope_idx",
+          "primary": false,
+          "unique": false
+        },
+        {
+          "columnNames": [],
+          "composite": false,
+          "constraint": false,
+          "keyName": "availability_policies_scope_target_unique",
+          "primary": false,
+          "unique": false,
+          "expression": "create unique index \"availability_policies_scope_target_unique\" on \"availability_policies\" (\"tenant_id\", \"organization_id\", \"store_id\", \"product_id\", \"variant_id\") nulls not distinct where deleted_at is null"
+        }
+      ],
+      "checks": [],
+      "triggers": [],
+      "foreignKeys": {},
+      "comment": null
+    }
+  ],
+  "views": [],
+  "nativeEnums": {}
+}

package/src/modules/availability/migrations/Migration20260922095844_availability.ts

@@ -0,0 +1,13 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260922095844_availability extends Migration {
+
+  override name = 'Migration20260922095844';
+
+  override up(): void | Promise<void> {
+    this.addSql(`create table "availability_policies" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "store_id" uuid null, "product_id" uuid null, "variant_id" uuid null, "is_stock_managed" boolean not null default false, "allow_backorder" boolean not null default false, "backorder_lead_time_days" int null, "preorder_release_at" timestamptz null, "low_stock_threshold" int null, "min_order_quantity" int null, "max_order_quantity" int null, "quantity_increment" int null, "hide_when_out_of_stock" boolean not null default false, "is_active" boolean not null default true, "created_at" timestamptz not null, "updated_at" timestamptz not null, "deleted_at" timestamptz null, primary key ("id"));`);
+    this.addSql(`create unique index "availability_policies_scope_target_unique" on "availability_policies" ("tenant_id", "organization_id", "store_id", "product_id", "variant_id") nulls not distinct where deleted_at is null;`);
+    this.addSql(`create index "availability_policies_scope_idx" on "availability_policies" ("tenant_id", "organization_id");`);
+  }
+
+}

package/src/modules/availability/migrations/Migration20260930120000_availability.ts

@@ -0,0 +1,22 @@
+import { Migration } from '@mikro-orm/migrations';
+
+export class Migration20260930120000_availability extends Migration {
+
+  override name = 'Migration20260930120000';
+
+  override up(): void | Promise<void> {
+    // `is_stock_managed` becomes nullable like the other cascading policy fields, so a
+    // policy row (notably an org-wide / store default) can leave it unset (`null`) and
+    // inherit it from the next less-specific row or the §5.2 module default.
+    // Existing values are kept as stored.
+    this.addSql(`alter table "availability_policies" alter column "is_stock_managed" drop default;`);
+    this.addSql(`alter table "availability_policies" alter column "is_stock_managed" drop not null;`);
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`update "availability_policies" set "is_stock_managed" = false where "is_stock_managed" is null;`);
+    this.addSql(`alter table "availability_policies" alter column "is_stock_managed" set default false;`);
+    this.addSql(`alter table "availability_policies" alter column "is_stock_managed" set not null;`);
+  }
+
+}

package/src/modules/availability/setup.ts

@@ -0,0 +1,10 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    admin: ['availability.*'],
+    employee: ['availability.policies.view'],
+  },
+}
+
+export default setup

package/src/modules/catalog/api/categories/bulk-create/route.ts

@@ -0,0 +1,133 @@
+import { NextResponse } from 'next/server'
+import { z } from 'zod'
+import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
+import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
+import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
+import { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'
+import type { ProgressService } from '../../../../progress/lib/progressService'
+import { categoriesBulkCreateSchema } from '../../../data/validators'
+import { DEFAULT_CHECKPOINT_INTERVAL } from '../../../lib/bulkCreateCheckpoint'
+import { runBulkCreateMutationGuards } from '../../../lib/bulkCreateMutationGuards'
+import {
+  CATALOG_CATEGORY_BULK_CREATE_QUEUE,
+  getCatalogQueue,
+} from '../../../lib/bulkCreateCategories'
+
+const MAX_REPORTED_ISSUES = 20
+
+const responseSchema = z.object({
+  ok: z.boolean(),
+  progressJobId: z.string().uuid().nullable(),
+  message: z.string(),
+  // Additive: existing consumers that only read `ok`/`progressJobId`/`message` are unaffected.
+  // A batch of up to several thousand structurally rich rows is impossible to debug from a bare
+  // "Invalid payload", so the first failing paths are reported back.
+  errors: z
+    .array(z.object({ path: z.string(), message: z.string() }))
+    .optional(),
+})
+
+export const metadata = {
+  POST: { requireAuth: true, requireFeatures: ['catalog.categories.manage'] },
+}
+
+export const openApi = {
+  tags: ['Catalog'],
+  summary: 'Start bulk creating catalog categories',
+}
+
+export async function POST(req: Request) {
+  const auth = await getAuthFromRequest(req)
+  if (!auth?.tenantId) {
+    return NextResponse.json(responseSchema.parse({
+      ok: false,
+      progressJobId: null,
+      message: 'Unauthorized',
+    }), { status: 401 })
+  }
+
+  const parsed = categoriesBulkCreateSchema.safeParse(await readJsonSafe(req))
+  if (!parsed.success) {
+    return NextResponse.json(responseSchema.parse({
+      ok: false,
+      progressJobId: null,
+      message: 'Invalid payload',
+      errors: parsed.error.issues.slice(0, MAX_REPORTED_ISSUES).map((issue) => ({
+        path: issue.path.join('.'),
+        message: issue.message,
+      })),
+    }), { status: 400 })
+  }
+
+  const items = parsed.data.items
+  const container = await createRequestContainer()
+  const scope = await resolveOrganizationScopeForRequest({ container, auth, request: req })
+  if (scope.selectionRejected) {
+    return NextResponse.json(responseSchema.parse({
+      ok: false,
+      progressJobId: null,
+      message: 'Your selected organization is no longer available. Please re-select an organization and try again.',
+    }), { status: 422 })
+  }
+  const organizationId = scope.selectedId
+  if (!organizationId) {
+    return NextResponse.json(responseSchema.parse({
+      ok: false,
+      progressJobId: null,
+      message: 'Organization context is required',
+    }), { status: 400 })
+  }
+
+  const guardDecision = await runBulkCreateMutationGuards({
+    container,
+    auth,
+    request: req,
+    tenantId: auth.tenantId,
+    organizationId,
+    userId: auth.sub ?? '',
+    resourceKind: 'catalog.category',
+    itemCount: items.length,
+  })
+  if (!guardDecision.ok) {
+    return NextResponse.json(guardDecision.body, { status: guardDecision.status })
+  }
+
+  const progressService = container.resolve('progressService') as ProgressService
+
+  const progressJob = await progressService.createJob(
+    {
+      jobType: 'catalog.categories.bulk_create',
+      name: 'Bulk create categories',
+      description: `${items.length} catalog categories queued for creation`,
+      totalCount: items.length,
+      cancellable: true,
+      meta: {
+        source: 'catalog.bulk-create',
+        checkpointInterval: DEFAULT_CHECKPOINT_INTERVAL,
+        lastCompletedRowIndex: -1,
+      },
+    },
+    {
+      tenantId: auth.tenantId,
+      organizationId,
+      userId: auth.sub,
+    },
+  )
+
+  const queue = getCatalogQueue(CATALOG_CATEGORY_BULK_CREATE_QUEUE)
+  await queue.enqueue({
+    progressJobId: progressJob.id,
+    items,
+    scope: {
+      organizationId,
+      tenantId: auth.tenantId,
+      userId: auth.sub,
+    },
+  })
+
+  return NextResponse.json(responseSchema.parse({
+    ok: true,
+    progressJobId: progressJob.id,
+    message: 'Bulk create started.',
+  }), { status: 202 })
+}

package/src/modules/catalog/api/categories/route.ts

@@ -9,6 +9,7 @@ import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/d
 import { resolveOrganizationScopeFilter } from '@open-mercato/core/modules/directory/utils/organizationScopeFilter'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { loadCustomFieldValues } from '@open-mercato/shared/lib/crud/custom-fields'
+import { runCustomRouteAfterInterceptors } from '@open-mercato/shared/lib/crud/custom-route-interceptor'
 import { E } from '#generated/entities.ids.generated'
 import { CatalogProductCategory } from '../../data/entities'
 import { categoryCreateSchema, categoryUpdateSchema } from '../../data/validators'
@@ -129,6 +130,51 @@ function parseIds(raw?: string | null): string[] | null {
   return parts.length ? Array.from(new Set(parts)) : null
 }
 
+function headersToObject(headers: Headers): Record<string, string> {
+  return Object.fromEntries(headers.entries())
+}
+
+function queryToObject(url: URL): Record<string, string> {
+  return Object.fromEntries(url.searchParams.entries())
+}
+
+async function categoriesResponse(args: {
+  req: Request
+  auth: Awaited<ReturnType<typeof getAuthFromRequest>> & {}
+  container: Awaited<ReturnType<typeof createRequestContainer>>
+  em: EntityManager
+  tenantId: string
+  organizationId: string | null
+  body: Record<string, unknown>
+}) {
+  const intercepted = await runCustomRouteAfterInterceptors({
+    routePath: 'catalog/categories',
+    method: 'GET',
+    request: {
+      method: 'GET',
+      url: args.req.url,
+      headers: headersToObject(args.req.headers),
+      query: queryToObject(new URL(args.req.url)),
+    },
+    response: { statusCode: 200, body: args.body, headers: {} },
+    context: {
+      em: args.em,
+      container: args.container,
+      userId: args.auth.sub,
+      organizationId: args.organizationId,
+      tenantId: args.tenantId,
+      userFeatures: Array.isArray(args.auth.features)
+        ? args.auth.features.filter((feature): feature is string => typeof feature === 'string')
+        : [],
+    },
+  })
+
+  return NextResponse.json(intercepted.body, {
+    status: intercepted.statusCode,
+    headers: intercepted.headers,
+  })
+}
+
 export async function GET(req: Request) {
   const auth = await getAuthFromRequest(req)
   if (!auth) return NextResponse.json({ items: [] }, { status: 401 })
@@ -199,7 +245,15 @@ export async function GET(req: Request) {
         roots.push(node)
       }
     }
-    return NextResponse.json({ items: roots })
+    return categoriesResponse({
+      req,
+      auth,
+      container,
+      em,
+      tenantId,
+      organizationId: responseOrganizationId,
+      body: { items: roots },
+    })
   }
 
   const status = query.status ?? 'all'
@@ -269,14 +323,22 @@ export async function GET(req: Request) {
   })
 
   const totalPages = Math.max(1, Math.ceil(total / pageSize))
-  return NextResponse.json({
-    items,
-    total,
-    page,
-    pageSize,
-    totalPages,
-    organizationId: responseOrganizationId,
+  return categoriesResponse({
+    req,
+    auth,
+    container,
+    em,
     tenantId,
+    organizationId: responseOrganizationId,
+    body: {
+      items,
+      total,
+      page,
+      pageSize,
+      totalPages,
+      organizationId: responseOrganizationId,
+      tenantId,
+    },
   })
 }