@open-mercato/core 0.6.8-develop.6993.1.3fc50f3409 → 0.6.8-develop.7000.1.0ae682bad1

package/src/modules/query_index/di.ts

@@ -1,17 +1,113 @@
-import type { AppContainer } from '@open-mercato/shared/lib/di/container'
-import { BasicQueryEngine, resolveEntityTableName } from '@open-mercato/shared/lib/query/engine'
-import { HybridQueryEngine } from './lib/engine'
-import { markDeleted } from './lib/indexer'
+import type { EntityManager } from '@mikro-orm/postgresql'
 import type { EventBus } from '@open-mercato/events'
 import type { VectorIndexService } from '@open-mercato/search/vector'
+import type { AppContainer } from '@open-mercato/shared/lib/di/container'
 import { CRUD_QUERY_INDEX_MANAGED_PAYLOAD_KEY } from '@open-mercato/shared/lib/crud/types'
+import { recordIndexerError } from '@open-mercato/shared/lib/indexers/error-log'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+import { BasicQueryEngine } from '@open-mercato/shared/lib/query/engine'
+import { HybridQueryEngine } from './lib/engine'
+import {
+  loadQueryIndexRowScope,
+  QueryIndexScopeError,
+  resolveQueryIndexRecordScope,
+  resolveQueryIndexSourceMetadata,
+} from './lib/subscriber-scope'
+
+const logger = createLogger('query_index').child({ component: 'crud-bridge' })
+
+function hasOwn(value: unknown, key: string): boolean {
+  return !!value && typeof value === 'object' && Object.prototype.hasOwnProperty.call(value, key)
+}
+
+function readScopeValue(
+  source: unknown,
+  keys: string[],
+): { value: string | null | undefined; present: boolean } {
+  const sourceRecord = source && typeof source === 'object' ? source as Record<string, unknown> : {}
+  const key = keys.find((candidate) => hasOwn(source, candidate))
+  if (!key) return { value: undefined, present: false }
+  const value = sourceRecord[key]
+  if (value === null) return { value: null, present: true }
+  if (typeof value === 'string' && value.trim().length > 0) return { value, present: true }
+  return { value: undefined, present: false }
+}
+
+async function resolveBridgeRecordScope(
+  em: EntityManager,
+  entityType: string,
+  recordId: string,
+  payload: unknown,
+  action: 'upsert' | 'delete',
+  options?: { validateCompletePayload?: boolean },
+) {
+  let organization = readScopeValue(payload, ['organizationId', 'orgId'])
+  let tenant = readScopeValue(payload, ['tenantId'])
+  if (organization.present && tenant.present && options?.validateCompletePayload !== true) {
+    return {
+      organizationId: organization.value ?? null,
+      tenantId: tenant.value ?? null,
+      sourceValidated: false,
+    }
+  }
+  const source = resolveQueryIndexSourceMetadata(em, entityType)
+  const sourceScope = await loadQueryIndexRowScope(em, source, recordId)
+
+  if (sourceScope.kind === 'global') {
+    if (!organization.present) organization = { value: null, present: true }
+    if (!tenant.present) tenant = { value: null, present: true }
+  } else if (sourceScope.kind === 'missing' && action === 'upsert') {
+    throw new QueryIndexScopeError(
+      'Query index upsert event source row scope could not be resolved',
+    )
+  }
 
-function toEntityTypeFromEvent(event: string): string | null {
-  // Expect '<module>.<entity>.<action>'
-  const parts = event.split('.')
-  if (parts.length !== 3) return null
-  const [mod, ent] = parts
-  return `${mod}:${ent}`
+  const resolvedScope = resolveQueryIndexRecordScope({
+    payloadOrganizationId: organization.value,
+    payloadTenantId: tenant.value,
+    hasPayloadOrganizationId: organization.present,
+    hasPayloadTenantId: tenant.present,
+    sourceScope,
+  })
+  return { ...resolvedScope, sourceValidated: true }
+}
+
+async function recordBridgeError(input: {
+  em: EntityManager | null
+  handler: 'upsert' | 'delete'
+  error: unknown
+  entityType: string
+  recordId: string
+  payload: unknown
+}): Promise<void> {
+  const handler = `event:query_index.crud_bridge.${input.handler}`
+  if (!input.em) {
+    logger.error('CRUD bridge event failed before the entity manager was resolved', {
+      handler,
+      entityType: input.entityType,
+      recordId: input.recordId,
+      err: input.error,
+    })
+    return
+  }
+  await recordIndexerError(
+    { em: input.em },
+    {
+      source: 'query_index',
+      handler,
+      error: input.error,
+      entityType: input.entityType,
+      recordId: input.recordId,
+      payload: input.payload,
+    },
+  ).catch((loggingError) => {
+    logger.error('Failed to record CRUD bridge error', {
+      handler,
+      entityType: input.entityType,
+      recordId: input.recordId,
+      err: loggingError,
+    })
+  })
 }
 
 export function register(container: AppContainer) {
@@ -65,30 +161,25 @@ export function register(container: AppContainer) {
     if (!bus) { setTimeout(setup, 0); return }
 
     const makeUpsertHandler = (entityType: string) => async (payload: any, ctx: any) => {
+      let em: EntityManager | null = null
+      let id = ''
       try {
         // DataEngine emits the canonical query_index.upsert_one itself. The
         // bridge only covers domain events from write paths that do not own an
         // indexer, otherwise failures and error logs are duplicated.
         if (payload?.[CRUD_QUERY_INDEX_MANAGED_PAYLOAD_KEY] === true) return
-        const em = ctx.resolve('em')
-        let orgId = payload?.organizationId || payload?.orgId || ctx?.organizationId || null
-        let tenantId = payload?.tenantId || ctx?.tenantId || null
-        const id = String(payload?.id || payload?.recordId || '')
+        em = ctx.resolve('em') as EntityManager
+        id = String(payload?.id || payload?.recordId || '')
         if (!id) return
-        if (!orgId || !tenantId) {
-          try {
-            const db = (em as any).getKysely()
-            const table = resolveEntityTableName(em, entityType)
-            const row = await db
-              .selectFrom(table as any)
-              .select(['organization_id' as any, 'tenant_id' as any])
-              .where('id' as any, '=', id)
-              .executeTakeFirst() as { organization_id: string | null; tenant_id: string | null } | undefined
-            orgId = row?.organization_id ?? orgId
-            tenantId = row?.tenant_id ?? tenantId
-          } catch {}
-        }
+        const { organizationId: orgId, tenantId, sourceValidated } = await resolveBridgeRecordScope(
+          em,
+          entityType,
+          id,
+          payload,
+          'upsert',
+        )
         // Optional: only index when custom field definitions exist for this entity (org/global)
+        let hasCustomFields: boolean | null = null
         try {
           const db = (em as any).getKysely()
           let cfQuery = db
@@ -112,41 +203,47 @@ export function register(container: AppContainer) {
           } else {
             cfQuery = cfQuery.where('tenant_id' as any, 'is', null as any)
           }
-          const hasCf = await cfQuery.executeTakeFirst()
-          if (!hasCf) return
+          hasCustomFields = !!await cfQuery.executeTakeFirst()
         } catch {}
-        try {
-          const bus = ctx.resolve('eventBus') as any
-          await bus.emitEvent('query_index.upsert_one', { entityType, recordId: id, organizationId: orgId, tenantId })
-        } catch {}
-      } catch {}
+        if (hasCustomFields === false) {
+          if (!sourceValidated) {
+            await resolveBridgeRecordScope(
+              em,
+              entityType,
+              id,
+              payload,
+              'upsert',
+              { validateCompletePayload: true },
+            )
+          }
+          return
+        }
+        const bus = ctx.resolve('eventBus') as any
+        await bus.emitEvent('query_index.upsert_one', { entityType, recordId: id, organizationId: orgId, tenantId })
+      } catch (error) {
+        await recordBridgeError({ em, handler: 'upsert', error, entityType, recordId: id, payload })
+      }
     }
     const makeDeleteHandler = (entityType: string) => async (payload: any, ctx: any) => {
+      let em: EntityManager | null = null
+      let id = ''
       try {
         if (payload?.[CRUD_QUERY_INDEX_MANAGED_PAYLOAD_KEY] === true) return
-        const em = ctx.resolve('em')
-        let orgId = payload?.organizationId || payload?.orgId || ctx?.organizationId || null
-        let tenantId = payload?.tenantId || ctx?.tenantId || null
-        const id = String(payload?.id || payload?.recordId || '')
+        em = ctx.resolve('em') as EntityManager
+        id = String(payload?.id || payload?.recordId || '')
         if (!id) return
-        if (!orgId || !tenantId) {
-          try {
-            const db = (em as any).getKysely()
-            const table = resolveEntityTableName(em, entityType)
-            const row = await db
-              .selectFrom(table as any)
-              .select(['organization_id' as any, 'tenant_id' as any])
-              .where('id' as any, '=', id)
-              .executeTakeFirst() as { organization_id: string | null; tenant_id: string | null } | undefined
-            orgId = row?.organization_id ?? orgId
-            tenantId = row?.tenant_id ?? tenantId
-          } catch {}
-        }
-        try {
-          const bus = ctx.resolve('eventBus') as any
-          await bus.emitEvent('query_index.delete_one', { entityType, recordId: id, organizationId: orgId, tenantId })
-        } catch {}
-      } catch {}
+        const { organizationId: orgId, tenantId } = await resolveBridgeRecordScope(
+          em,
+          entityType,
+          id,
+          payload,
+          'delete',
+        )
+        const bus = ctx.resolve('eventBus') as any
+        await bus.emitEvent('query_index.delete_one', { entityType, recordId: id, organizationId: orgId, tenantId })
+      } catch (error) {
+        await recordBridgeError({ em, handler: 'delete', error, entityType, recordId: id, payload })
+      }
     }
 
     // Build list of entity ids to subscribe to

package/src/modules/sales/commands/documents.ts

@@ -594,6 +594,11 @@ export const documentUpdateSchema = z
     customerReference: z.string().nullable().optional(),
     externalReference: z.string().nullable().optional(),
     comment: z.string().nullable().optional(),
+    // Same names and limits as the create schema (data/validators.ts), so a
+    // caller can send one payload shape to create and update. Nullable here
+    // because an update — unlike a create — has an existing value to clear.
+    comments: z.string().trim().max(4000).nullable().optional(),
+    internalNotes: z.string().trim().max(4000).nullable().optional(),
     orderNumber: z.string().trim().min(1).max(191).optional(),
     quoteNumber: z.string().trim().min(1).max(191).optional(),
     currencyCode: currencyCodeSchema.optional(),
@@ -637,6 +642,8 @@ export const documentUpdateSchema = z
       input.customerReference !== undefined ||
       input.externalReference !== undefined ||
       input.comment !== undefined ||
+      input.comments !== undefined ||
+      input.internalNotes !== undefined ||
       input.orderNumber !== undefined ||
       input.quoteNumber !== undefined ||
       input.shippingAddressSnapshot !== undefined ||
@@ -1162,6 +1169,32 @@ async function applyDocumentUpdate({
       typeof input.comment === "string" ? input.comment.trim() : "";
     entity.comments = normalized.length ? normalized : null;
   }
+  // After `comment`, so the canonical name wins when a payload carries both.
+  if (input.comments !== undefined) {
+    const normalized =
+      typeof input.comments === "string" ? input.comments.trim() : "";
+    entity.comments = normalized.length ? normalized : null;
+  }
+  // Orders only — SalesQuote has no internalNotes column. Reject rather than
+  // ignore it on a quote: the field now satisfies the schema's refine on its
+  // own, so silently dropping it would let an otherwise-empty payload run the
+  // update, and a quote in `sent` status loses its acceptance token and reverts
+  // to draft on any update that reaches execution.
+  if (kind === "quote" && input.internalNotes !== undefined) {
+    throw new CrudHttpError(400, {
+      error: translate(
+        "sales.quotes.internal_notes_unsupported",
+        "Internal notes are not available on quotes.",
+      ),
+    });
+  }
+  if (kind === "order" && input.internalNotes !== undefined) {
+    const normalized =
+      typeof input.internalNotes === "string" ? input.internalNotes.trim() : "";
+    (entity as SalesOrder).internalNotes = normalized.length
+      ? normalized
+      : null;
+  }
   if (typeof input.currencyCode === "string") {
     entity.currencyCode = input.currencyCode;
   }
@@ -2079,8 +2112,8 @@ async function loadCreditMemoSnapshot(
       organizationId: creditMemo.organizationId,
       tenantId: creditMemo.tenantId,
       creditMemoNumber: creditMemo.creditMemoNumber,
-      orderId: creditMemo.orderId ?? null,
-      invoiceId: creditMemo.invoiceId ?? null,
+      orderId: creditMemo.order?.id ?? null,
+      invoiceId: creditMemo.invoice?.id ?? null,
       statusEntryId: creditMemo.statusEntryId ?? null,
       status: creditMemo.status ?? null,
       reason: creditMemo.reason ?? null,
@@ -3692,9 +3725,11 @@ function buildDocumentUpdateChangeKeys(kind: SalesDocumentKind, input: DocumentU
   if (input.customerSnapshot !== undefined) keys.add("customerSnapshot");
   if (input.metadata !== undefined) keys.add("metadata");
   if (input.comment !== undefined) keys.add("comments");
+  if (input.comments !== undefined) keys.add("comments");
   if (input.currencyCode !== undefined) keys.add("currencyCode");
   if (input.channelId !== undefined) keys.add("channelId");
   if (kind === "order") {
+    if (input.internalNotes !== undefined) keys.add("internalNotes");
     if (input.placedAt !== undefined) keys.add("placedAt");
     if (input.expectedDeliveryAt !== undefined) keys.add("expectedDeliveryAt");
   }
@@ -5159,10 +5194,6 @@ const updateQuoteCommand: CommandHandler<
     ensureQuoteScope(ctx, quote.organizationId, quote.tenantId);
     await enforceSalesDocumentOptimisticLock(ctx, quote, SALES_RESOURCE_KIND_QUOTE);
     const shouldInvalidateSentToken = (quote.status ?? null) === "sent";
-    if (shouldInvalidateSentToken) {
-      quote.acceptanceToken = null;
-      quote.sentAt = null;
-    }
     const shouldRecalculateTotals =
       parsed.shippingMethodId !== undefined ||
       parsed.shippingMethodSnapshot !== undefined ||
@@ -5185,7 +5216,12 @@ const updateQuoteCommand: CommandHandler<
             input: parsed,
             em,
           });
+          // After applyDocumentUpdate, not before it: the reset must not happen
+          // for an update that turns out to be invalid, or a rejected payload
+          // still strips a sent quote of its acceptance link.
           if (shouldInvalidateSentToken) {
+            quote.acceptanceToken = null;
+            quote.sentAt = null;
             quote.status = "draft";
             quote.statusEntryId = await resolveStatusEntryIdByValue(em, {
               tenantId: quote.tenantId,
@@ -9435,8 +9471,8 @@ const createCreditMemoCommand: CommandHandler<
       organizationId: parsed.organizationId,
       tenantId: parsed.tenantId,
       creditMemoNumber: ensuredCreditMemoNumber,
-      orderId: parsed.orderId ?? null,
-      invoiceId: parsed.invoiceId ?? null,
+      order: parsed.orderId ? em.getReference(SalesOrder, parsed.orderId) : null,
+      invoice: parsed.invoiceId ? em.getReference(SalesInvoice, parsed.invoiceId) : null,
       statusEntryId: parsed.statusEntryId ?? null,
       status,
       reason: parsed.reason ?? null,
@@ -9686,8 +9722,12 @@ const updateCreditMemoCommand: CommandHandler<
     ensureOrganizationScope(ctx, creditMemo.organizationId);
     ensureTenantScope(ctx, creditMemo.tenantId);
     creditMemo.creditMemoNumber = before.creditMemo.creditMemoNumber;
-    creditMemo.orderId = before.creditMemo.orderId;
-    creditMemo.invoiceId = before.creditMemo.invoiceId;
+    creditMemo.order = before.creditMemo.orderId
+      ? em.getReference(SalesOrder, before.creditMemo.orderId)
+      : null;
+    creditMemo.invoice = before.creditMemo.invoiceId
+      ? em.getReference(SalesInvoice, before.creditMemo.invoiceId)
+      : null;
     creditMemo.statusEntryId = before.creditMemo.statusEntryId;
     creditMemo.status = before.creditMemo.status;
     creditMemo.reason = before.creditMemo.reason;
@@ -9790,8 +9830,12 @@ const deleteCreditMemoCommand: CommandHandler<
       organizationId: before.creditMemo.organizationId,
       tenantId: before.creditMemo.tenantId,
       creditMemoNumber: before.creditMemo.creditMemoNumber,
-      orderId: before.creditMemo.orderId,
-      invoiceId: before.creditMemo.invoiceId,
+      order: before.creditMemo.orderId
+        ? em.getReference(SalesOrder, before.creditMemo.orderId)
+        : null,
+      invoice: before.creditMemo.invoiceId
+        ? em.getReference(SalesInvoice, before.creditMemo.invoiceId)
+        : null,
       statusEntryId: before.creditMemo.statusEntryId,
       status: before.creditMemo.status,
       reason: before.creditMemo.reason,

package/src/modules/sales/i18n/de.json

@@ -1287,6 +1287,7 @@
   "sales.quotes.form.general": "Allgemein",
   "sales.quotes.form.lines": "Positionen",
   "sales.quotes.form.notes": "Notizen",
+  "sales.quotes.internal_notes_unsupported": "Interne Notizen sind für Angebote nicht verfügbar.",
   "sales.quotes.lines.delete": "Angebotsposition löschen",
   "sales.quotes.lines.upsert": "Angebotsposition aktualisieren",
   "sales.quotes.list.title": "Angebote",

package/src/modules/sales/i18n/en.json

@@ -1287,6 +1287,7 @@
   "sales.quotes.form.general": "General",
   "sales.quotes.form.lines": "Line Items",
   "sales.quotes.form.notes": "Notes",
+  "sales.quotes.internal_notes_unsupported": "Internal notes are not available on quotes.",
   "sales.quotes.lines.delete": "Delete quote line",
   "sales.quotes.lines.upsert": "Update quote line",
   "sales.quotes.list.title": "Quotes",

package/src/modules/sales/i18n/es.json

@@ -1287,6 +1287,7 @@
   "sales.quotes.form.general": "General",
   "sales.quotes.form.lines": "Líneas",
   "sales.quotes.form.notes": "Notas",
+  "sales.quotes.internal_notes_unsupported": "Las notas internas no están disponibles en los presupuestos.",
   "sales.quotes.lines.delete": "Eliminar línea de cotización",
   "sales.quotes.lines.upsert": "Actualizar línea de cotización",
   "sales.quotes.list.title": "Cotizaciones",

package/src/modules/sales/i18n/ko.json

@@ -1287,6 +1287,7 @@
   "sales.quotes.form.general": "일반",
   "sales.quotes.form.lines": "라인 항목",
   "sales.quotes.form.notes": "메모",
+  "sales.quotes.internal_notes_unsupported": "내부 메모는 견적서에서 사용할 수 없습니다.",
   "sales.quotes.lines.delete": "견적 항목 삭제",
   "sales.quotes.lines.upsert": "견적 항목 업데이트",
   "sales.quotes.list.title": "견적",

package/src/modules/sales/i18n/pl.json

@@ -1287,6 +1287,7 @@
   "sales.quotes.form.general": "Ogólne",
   "sales.quotes.form.lines": "Pozycje",
   "sales.quotes.form.notes": "Notatki",
+  "sales.quotes.internal_notes_unsupported": "Notatki wewnętrzne nie są dostępne dla ofert.",
   "sales.quotes.lines.delete": "Usuń pozycję oferty",
   "sales.quotes.lines.upsert": "Zaktualizuj pozycję oferty",
   "sales.quotes.list.title": "Oferty",

package/src/modules/warranty_claims/AGENTS.md

@@ -0,0 +1,49 @@
+# Warranty Claims Module — Agent Guidelines
+
+`warranty_claims` is the B2B warranty, RMA, core-return, and vendor-recovery claims desk. It owns the claim aggregate, line-level partials, customer-visible timeline, staff notifications, portal intake, SLA settings, risk signals, and sales-order tab injection while coupling to other modules only through IDs, snapshots, events, QueryEngine lookups, and widgets.
+
+Covers claim lifecycle + line dispositions, receiving & grading, SLA pause/escalation, risk signals & adjudication, registrations & vendor recovery, portal + API-key intake, and resolution-execution bridges into `sales`. Design of record: [`.ai/specs/2026-07-03-warranty-rma-claims-desk.md`](../../../../../.ai/specs/2026-07-03-warranty-rma-claims-desk.md); unimplemented candidates: [`.ai/specs/2026-07-16-warranty-rma-roadmap.md`](../../../../../.ai/specs/2026-07-16-warranty-rma-roadmap.md).
+
+## Always
+
+1. MUST keep claim lifecycle transitions in `lib/stateMachine.ts` and `data/constants.ts`; the status enum is FROZEN and lifecycle moves MUST go through `warranty_claims.claim.transition`, never generic `PUT`.
+2. MUST preserve legal transitions: `closed -> in_review` is the reopen path, `cancelled` is terminal, and direct status writes through CRUD update are forbidden.
+3. MUST treat claim lines as first-class partials with dispositions; line create/update/delete MUST recompute header money rollups inside the same atomic flush.
+4. MUST keep SLA behavior settings-driven from `lib/settings.ts` and `/api/warranty_claims/settings-general`: due dates come from settings/defaults, `info_requested` pauses when configured, and resume shifts the due date instead of shortening the SLA window.
+5. MUST keep auto-adjudication default OFF, risk-gated by `lib/risk.ts`, executed only inside the submit command path, and limited to auto-approval; never auto-deny.
+6. MUST keep risk signals deterministic, tenant/org scoped, and based on code constants in `lib/risk.ts`; do not make thresholds tenant data without a spec.
+7. MUST preserve the event split: `warranty_claims.claim.status_changed` is the staff/client broadcast and MUST NOT pin `recipientUserIds`; `warranty_claims.claim.portal_status_changed` is the portal broadcast and MUST pin customer-user recipient ids, skipping emit when there are no recipients.
+8. MUST use FK-id plus snapshot coupling for sales, customers, catalog, and auth data; use QueryEngine or scoped decrypted lookups wrapped in `try/catch` for optional peer lookups.
+9. MUST carry `tenantId` and `organizationId` in every ORM `where` clause. The scope argument to `findOneWithDecryption` / `findWithDecryption` is decryption scope only and does not add SQL filters.
+10. MUST pin portal reads and writes to the server-resolved customer id; portal mutation guards use the customer-user id with an empty feature list.
+11. MUST keep optimistic locking on by default for CRUD and settings; action endpoints use `enforceCommandOptimisticLock`, and UI line mutations send each line's own `updatedAt` header.
+12. MUST keep free-text/correspondence fields in `encryption.ts` encrypted and excluded from search sources in `search.ts`.
+
+## Ask First
+
+- Ask before adding, renaming, or removing claim statuses, line statuses, dispositions, event ids, notification ids, API paths, widget spot ids, ACL ids, DI keys, or search entity ids.
+- Ask before changing lifecycle semantics, reopen behavior, cancellation rules, SLA pause/resume math, risk thresholds, auto-adjudication policy, or vendor-recovery reconciliation.
+- Ask before importing another module's ORM entity, writing to sales/customers/auth aggregates, or replacing FK-id plus snapshot coupling with direct relations.
+- Ask before changing portal ownership rules, customer-user recipient selection, attachment ownership, or customer-visible timeline visibility.
+
+## Never
+
+- Never change `claimType` or `status` through generic CRUD update.
+- Never import sales, customers, catalog, or auth ORM entities into this module.
+- Never emit a portal-broadcast event without pinned customer-user recipients.
+- Never rely on `findOneWithDecryption` scope to tenant-filter data; missing tenant/org in `where` is a data isolation bug.
+- Never bypass mutation guards, command optimistic locks, encrypted field helpers, or atomic flush for claim/line writes.
+- Never put encrypted text fields such as notes, resolution summary, fault description, inspection notes, or event body into search source text.
+- Never edit `i18n/*.json` in packet work; record new keys and English fallbacks in the packet notes file.
+
+## Validation Commands
+
+```bash
+cd packages/core
+npx jest src/modules/warranty_claims/__tests__
+cd ../..
+yarn generate
+yarn i18n:check-sync
+```
+
+Integration coverage lives under `packages/core/src/modules/warranty_claims/__integration__/TC-WC-*.spec.ts`; run the relevant `TC-WC-*` scenario when changing API or portal behavior.

package/src/modules/warranty_claims/acl.ts

@@ -0,0 +1,71 @@
+export const features = [
+  { id: 'warranty_claims.claim.view', title: 'View warranty claims', module: 'warranty_claims' },
+  {
+    id: 'warranty_claims.claim.create',
+    title: 'Create warranty claims',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.view'],
+  },
+  {
+    id: 'warranty_claims.claim.manage',
+    title: 'Manage warranty claims',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.view'],
+  },
+  {
+    id: 'warranty_claims.claim.delete',
+    title: 'Delete warranty claims',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.manage'],
+  },
+  {
+    id: 'warranty_claims.settings.manage',
+    title: 'Manage warranty claim settings',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.manage'],
+  },
+  {
+    id: 'warranty_claims.external.submit',
+    title: 'Submit external warranty claims',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.create'],
+  },
+  {
+    id: 'warranty_claims.external.view',
+    title: 'View external warranty claims',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.view'],
+  },
+  {
+    id: 'warranty_claims.registration.view',
+    title: 'View warranty registrations',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.view'],
+  },
+  {
+    id: 'warranty_claims.registration.manage',
+    title: 'Manage warranty registrations',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.registration.view'],
+  },
+  {
+    id: 'warranty_claims.vendor_policy.manage',
+    title: 'Manage warranty vendor policies',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.manage'],
+  },
+  {
+    id: 'warranty_claims.troubleshooting.manage',
+    title: 'Manage warranty troubleshooting guides',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.settings.manage'],
+  },
+  {
+    id: 'warranty_claims.receiving.manage',
+    title: 'Manage warranty receiving and grading',
+    module: 'warranty_claims',
+    dependsOn: ['warranty_claims.claim.manage'],
+  },
+]
+
+export default features