@open-mercato/core 0.6.4-develop.4382.1.6b4f656b77 → 0.6.4

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

@@ -1,6 +1,8 @@
 // @ts-nocheck
 
 import { registerCommand, type CommandHandler } from '@open-mercato/shared/lib/commands'
+import { emitCrudSideEffects } from '@open-mercato/shared/lib/commands/helpers'
+import type { DataEngine } from '@open-mercato/shared/lib/data/engine'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
 import {
@@ -8,12 +10,123 @@ import {
   documentAddressDeleteSchema,
   documentAddressUpdateSchema,
   type DocumentAddressCreateInput,
+  type DocumentAddressDeleteInput,
   type DocumentAddressUpdateInput,
 } from '../data/validators'
 import { SalesDocumentAddress, SalesOrder, SalesQuote } from '../data/entities'
-import { ensureOrganizationScope, ensureSameScope, ensureTenantScope, assertFound } from './shared'
+import { ensureOrganizationScope, ensureSameScope, ensureTenantScope, assertFound, extractUndoPayload } from './shared'
 import { loadSalesSettings } from './settings'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { E } from '#generated/entities.ids.generated'
+
+const DOCUMENT_ADDRESS_ENTITY_TYPE = E.sales.sales_document_address
+
+type DocumentAddressSnapshot = {
+  id: string
+  organizationId: string
+  tenantId: string
+  documentId: string
+  documentKind: 'order' | 'quote'
+  customerAddressId: string | null
+  name: string | null
+  purpose: string | null
+  companyName: string | null
+  addressLine1: string
+  addressLine2: string | null
+  buildingNumber: string | null
+  flatNumber: string | null
+  city: string | null
+  region: string | null
+  postalCode: string | null
+  country: string | null
+  latitude: number | null
+  longitude: number | null
+}
+
+type DocumentAddressUndoPayload = {
+  before?: DocumentAddressSnapshot | null
+  after?: DocumentAddressSnapshot | null
+}
+
+function snapshotDocumentAddress(entity: SalesDocumentAddress): DocumentAddressSnapshot {
+  return {
+    id: entity.id,
+    organizationId: entity.organizationId,
+    tenantId: entity.tenantId,
+    documentId: entity.documentId,
+    documentKind: entity.documentKind as 'order' | 'quote',
+    customerAddressId: entity.customerAddressId ?? null,
+    name: entity.name ?? null,
+    purpose: entity.purpose ?? null,
+    companyName: entity.companyName ?? null,
+    addressLine1: entity.addressLine1,
+    addressLine2: entity.addressLine2 ?? null,
+    buildingNumber: entity.buildingNumber ?? null,
+    flatNumber: entity.flatNumber ?? null,
+    city: entity.city ?? null,
+    region: entity.region ?? null,
+    postalCode: entity.postalCode ?? null,
+    country: entity.country ?? null,
+    latitude: entity.latitude ?? null,
+    longitude: entity.longitude ?? null,
+  }
+}
+
+async function loadDocumentAddressSnapshot(
+  em: EntityManager,
+  id: string
+): Promise<DocumentAddressSnapshot | null> {
+  const entity = await em.findOne(SalesDocumentAddress, { id })
+  return entity ? snapshotDocumentAddress(entity) : null
+}
+
+function applyDocumentAddressSnapshot(em: EntityManager, entity: SalesDocumentAddress, snapshot: DocumentAddressSnapshot): void {
+  entity.organizationId = snapshot.organizationId
+  entity.tenantId = snapshot.tenantId
+  entity.documentId = snapshot.documentId
+  entity.documentKind = snapshot.documentKind
+  entity.customerAddressId = snapshot.customerAddressId
+  entity.name = snapshot.name
+  entity.purpose = snapshot.purpose
+  entity.companyName = snapshot.companyName
+  entity.addressLine1 = snapshot.addressLine1
+  entity.addressLine2 = snapshot.addressLine2
+  entity.buildingNumber = snapshot.buildingNumber
+  entity.flatNumber = snapshot.flatNumber
+  entity.city = snapshot.city
+  entity.region = snapshot.region
+  entity.postalCode = snapshot.postalCode
+  entity.country = snapshot.country
+  entity.latitude = snapshot.latitude
+  entity.longitude = snapshot.longitude
+  entity.order = snapshot.documentKind === 'order' ? em.getReference(SalesOrder, snapshot.documentId) : null
+  entity.quote = snapshot.documentKind === 'quote' ? em.getReference(SalesQuote, snapshot.documentId) : null
+}
+
+async function emitDocumentAddressIndexSideEffects(
+  ctx: { container: { resolve: (name: string) => unknown } },
+  action: 'created' | 'updated' | 'deleted',
+  snapshot: DocumentAddressSnapshot
+): Promise<void> {
+  let dataEngine: DataEngine | null = null
+  try {
+    dataEngine = ctx.container.resolve('dataEngine') as DataEngine
+  } catch {
+    dataEngine = null
+  }
+  if (!dataEngine) return
+  await emitCrudSideEffects({
+    dataEngine,
+    action,
+    entity: snapshot,
+    identifiers: {
+      id: snapshot.id,
+      organizationId: snapshot.organizationId,
+      tenantId: snapshot.tenantId,
+    },
+    indexer: { entityType: DOCUMENT_ADDRESS_ENTITY_TYPE },
+  })
+}
 
 async function requireDocument(
   em: EntityManager,
@@ -90,10 +203,48 @@ const createDocumentAddress: CommandHandler<DocumentAddressCreateInput, { id: st
     await em.persist(entity).flush()
     return { id: entity.id }
   },
+  captureAfter: async (_input, result, ctx) => {
+    const em = (ctx.container.resolve('em') as EntityManager).fork()
+    return result?.id ? loadDocumentAddressSnapshot(em, result.id) : null
+  },
+  buildLog: async ({ result, snapshots }) => {
+    const after = snapshots.after as DocumentAddressSnapshot | undefined
+    if (!after) return null
+    const { translate } = await resolveTranslations()
+    return {
+      actionLabel: translate('sales.audit.document_addresses.create', 'Add document address'),
+      resourceKind: 'sales.document_address',
+      resourceId: result.id,
+      parentResourceKind: after.documentKind === 'order' ? 'sales.order' : 'sales.quote',
+      parentResourceId: after.documentId,
+      tenantId: after.tenantId,
+      organizationId: after.organizationId,
+      snapshotAfter: after,
+      payload: { undo: { after } satisfies DocumentAddressUndoPayload },
+    }
+  },
+  undo: async ({ logEntry, ctx }) => {
+    const payload = extractUndoPayload<DocumentAddressUndoPayload>(logEntry)
+    const after = payload?.after
+    if (!after) return
+    ensureTenantScope(ctx, after.tenantId)
+    ensureOrganizationScope(ctx, after.organizationId)
+    const em = (ctx.container.resolve('em') as EntityManager).fork()
+    const entity = await em.findOne(SalesDocumentAddress, { id: after.id })
+    if (!entity) return
+    await em.remove(entity).flush()
+    await emitDocumentAddressIndexSideEffects(ctx, 'deleted', after)
+  },
 }
 
 const updateDocumentAddress: CommandHandler<DocumentAddressUpdateInput, { id: string }> = {
   id: 'sales.document-addresses.update',
+  async prepare(rawInput, ctx) {
+    const parsed = documentAddressUpdateSchema.parse(rawInput)
+    const em = ctx.container.resolve('em') as EntityManager
+    const snapshot = await loadDocumentAddressSnapshot(em, parsed.id)
+    return snapshot ? { before: snapshot } : {}
+  },
   async execute(rawInput, ctx) {
     const input = documentAddressUpdateSchema.parse(rawInput)
     ensureTenantScope(ctx, input.tenantId)
@@ -133,13 +284,55 @@ const updateDocumentAddress: CommandHandler<DocumentAddressUpdateInput, { id: st
     await em.flush()
     return { id: entity.id }
   },
+  captureAfter: async (_input, result, ctx) => {
+    const em = (ctx.container.resolve('em') as EntityManager).fork()
+    return result?.id ? loadDocumentAddressSnapshot(em, result.id) : null
+  },
+  buildLog: async ({ result, snapshots }) => {
+    const before = snapshots.before as DocumentAddressSnapshot | undefined
+    const after = snapshots.after as DocumentAddressSnapshot | undefined
+    if (!after) return null
+    const { translate } = await resolveTranslations()
+    return {
+      actionLabel: translate('sales.audit.document_addresses.update', 'Update document address'),
+      resourceKind: 'sales.document_address',
+      resourceId: result.id,
+      parentResourceKind: after.documentKind === 'order' ? 'sales.order' : 'sales.quote',
+      parentResourceId: after.documentId,
+      tenantId: after.tenantId,
+      organizationId: after.organizationId,
+      snapshotBefore: before ?? null,
+      snapshotAfter: after,
+      payload: { undo: { before: before ?? null, after } satisfies DocumentAddressUndoPayload },
+    }
+  },
+  undo: async ({ logEntry, ctx }) => {
+    const payload = extractUndoPayload<DocumentAddressUndoPayload>(logEntry)
+    const before = payload?.before
+    if (!before) return
+    ensureTenantScope(ctx, before.tenantId)
+    ensureOrganizationScope(ctx, before.organizationId)
+    const em = (ctx.container.resolve('em') as EntityManager).fork()
+    const entity =
+      (await em.findOne(SalesDocumentAddress, { id: before.id })) ??
+      em.create(SalesDocumentAddress, { id: before.id } as Partial<SalesDocumentAddress>)
+    applyDocumentAddressSnapshot(em, entity, before)
+    await em.persist(entity).flush()
+    await emitDocumentAddressIndexSideEffects(ctx, 'updated', before)
+  },
 }
 
 const deleteDocumentAddress: CommandHandler<
-  { id: string; documentId: string; documentKind: 'order' | 'quote'; organizationId: string; tenantId: string },
-  { ok: true }
+  DocumentAddressDeleteInput,
+  { ok: true; id: string }
 > = {
   id: 'sales.document-addresses.delete',
+  async prepare(rawInput, ctx) {
+    const parsed = documentAddressDeleteSchema.parse(rawInput)
+    const em = ctx.container.resolve('em') as EntityManager
+    const snapshot = await loadDocumentAddressSnapshot(em, parsed.id)
+    return snapshot ? { before: snapshot } : {}
+  },
   async execute(rawInput, ctx) {
     const input = documentAddressDeleteSchema.parse(rawInput)
     ensureTenantScope(ctx, input.tenantId)
@@ -159,7 +352,36 @@ const deleteDocumentAddress: CommandHandler<
       })
     }
     await em.remove(entity).flush()
-    return { ok: true }
+    return { ok: true, id: input.id }
+  },
+  buildLog: async ({ result, snapshots }) => {
+    const before = snapshots.before as DocumentAddressSnapshot | undefined
+    if (!before) return null
+    const { translate } = await resolveTranslations()
+    return {
+      actionLabel: translate('sales.audit.document_addresses.delete', 'Remove document address'),
+      resourceKind: 'sales.document_address',
+      resourceId: result.id,
+      parentResourceKind: before.documentKind === 'order' ? 'sales.order' : 'sales.quote',
+      parentResourceId: before.documentId,
+      tenantId: before.tenantId,
+      organizationId: before.organizationId,
+      snapshotBefore: before,
+      payload: { undo: { before } satisfies DocumentAddressUndoPayload },
+    }
+  },
+  undo: async ({ logEntry, ctx }) => {
+    const payload = extractUndoPayload<DocumentAddressUndoPayload>(logEntry)
+    const before = payload?.before
+    if (!before) return
+    ensureTenantScope(ctx, before.tenantId)
+    ensureOrganizationScope(ctx, before.organizationId)
+    const em = (ctx.container.resolve('em') as EntityManager).fork()
+    const existing = await em.findOne(SalesDocumentAddress, { id: before.id })
+    const entity = existing ?? em.create(SalesDocumentAddress, { id: before.id } as Partial<SalesDocumentAddress>)
+    applyDocumentAddressSnapshot(em, entity, before)
+    await em.persist(entity).flush()
+    await emitDocumentAddressIndexSideEffects(ctx, 'created', before)
   },
 }
 

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

@@ -96,6 +96,9 @@ import {
   ensureTenantScope,
   extractUndoPayload,
   toNumericString,
+  enforceSalesDocumentOptimisticLock,
+  SALES_RESOURCE_KIND_ORDER,
+  SALES_RESOURCE_KIND_QUOTE,
 } from "./shared";
 import {
   loadShipmentSnapshot,
@@ -1072,6 +1075,7 @@ async function applyDocumentUpdate({
     const statusValue = await resolveDictionaryEntryValue(
       em,
       input.statusEntryId,
+      { tenantId },
     );
     if (input.statusEntryId && !statusValue) {
       throw new CrudHttpError(400, {
@@ -3026,7 +3030,7 @@ async function applyOrderLineResults(params: {
   const resolveStatus = async (entryId?: string | null) => {
     if (!entryId) return null;
     if (statusCache.has(entryId)) return statusCache.get(entryId) ?? null;
-    const value = await resolveDictionaryEntryValue(em, entryId);
+    const value = await resolveDictionaryEntryValue(em, entryId, { tenantId: order.tenantId });
     statusCache.set(entryId, value);
     return value;
   };
@@ -3100,7 +3104,7 @@ async function applyQuoteLineResults(params: {
   const resolveStatus = async (entryId?: string | null) => {
     if (!entryId) return null;
     if (statusCache.has(entryId)) return statusCache.get(entryId) ?? null;
-    const value = await resolveDictionaryEntryValue(em, entryId);
+    const value = await resolveDictionaryEntryValue(em, entryId, { tenantId: quote.tenantId });
     statusCache.set(entryId, value);
     return value;
   };
@@ -3167,7 +3171,7 @@ async function replaceQuoteLines(
   const resolveStatus = async (entryId?: string | null) => {
     if (!entryId) return null;
     if (statusCache.has(entryId)) return statusCache.get(entryId) ?? null;
-    const value = await resolveDictionaryEntryValue(em, entryId);
+    const value = await resolveDictionaryEntryValue(em, entryId, { tenantId: quote.tenantId });
     statusCache.set(entryId, value);
     return value;
   };
@@ -3295,7 +3299,7 @@ async function replaceOrderLines(
   const resolveStatus = async (entryId?: string | null) => {
     if (!entryId) return null;
     if (statusCache.has(entryId)) return statusCache.get(entryId) ?? null;
-    const value = await resolveDictionaryEntryValue(em, entryId);
+    const value = await resolveDictionaryEntryValue(em, entryId, { tenantId: order.tenantId });
     statusCache.set(entryId, value);
     return value;
   };
@@ -4446,6 +4450,7 @@ const createQuoteCommand: CommandHandler<
     const quoteStatus = await resolveDictionaryEntryValue(
       em,
       parsed.statusEntryId ?? null,
+      { tenantId: parsed.tenantId },
     );
     const quoteId = randomUUID();
     const quote = em.create(SalesQuote, {
@@ -4935,6 +4940,7 @@ const updateQuoteCommand: CommandHandler<
     if (!quote)
       throw new CrudHttpError(404, { error: "Sales quote not found" });
     ensureQuoteScope(ctx, quote.organizationId, quote.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, quote, SALES_RESOURCE_KIND_QUOTE);
     const shouldInvalidateSentToken = (quote.status ?? null) === "sent";
     if (shouldInvalidateSentToken) {
       quote.acceptanceToken = null;
@@ -4970,6 +4976,13 @@ const updateQuoteCommand: CommandHandler<
               value: "draft",
             });
           }
+        },
+        // Scalar mutations above are persisted by withAtomicFlush's per-phase
+        // flush boundary before the recalc reads below run any query on the same
+        // EntityManager. MikroORM v7 would otherwise silently discard pending
+        // scalar changes on `quote` when the `em.find` line/adjustment lookups
+        // reset the changeset (see SPEC-018).
+        async () => {
           if (shouldRecalculateTotals) {
             const [existingLines, adjustments] = await Promise.all([
               em.find(
@@ -5183,6 +5196,14 @@ const updateOrderCommand: CommandHandler<
             input: parsed,
             em,
           });
+        },
+        // Scalar mutations above are persisted by withAtomicFlush's per-phase
+        // flush boundary before the recalc reads and the status-change-note
+        // lookup below run any query on the same EntityManager. MikroORM v7 would
+        // otherwise silently discard pending scalar changes on `order` when the
+        // `em.find` lines/adjustments or appendOrderStatusChangeNote queries
+        // reset the changeset (see SPEC-018).
+        async () => {
           if (shouldRecalculateTotals) {
             const [existingLines, adjustments] = await Promise.all([
               em.find(
@@ -5394,9 +5415,9 @@ const createOrderCommand: CommandHandler<
     ensureOrderScope(ctx, parsed.organizationId, parsed.tenantId);
     const em = (ctx.container.resolve("em") as EntityManager).fork();
     const [status, fulfillmentStatus, paymentStatus] = await Promise.all([
-      resolveDictionaryEntryValue(em, parsed.statusEntryId ?? null),
-      resolveDictionaryEntryValue(em, parsed.fulfillmentStatusEntryId ?? null),
-      resolveDictionaryEntryValue(em, parsed.paymentStatusEntryId ?? null),
+      resolveDictionaryEntryValue(em, parsed.statusEntryId ?? null, { tenantId: parsed.tenantId }),
+      resolveDictionaryEntryValue(em, parsed.fulfillmentStatusEntryId ?? null, { tenantId: parsed.tenantId }),
+      resolveDictionaryEntryValue(em, parsed.paymentStatusEntryId ?? null, { tenantId: parsed.tenantId }),
     ]);
     const {
       customerSnapshot: resolvedCustomerSnapshot,
@@ -5984,6 +6005,7 @@ const convertQuoteToOrderCommand: CommandHandler<
           ),
         });
       ensureQuoteScope(ctx, quote.organizationId, quote.tenantId);
+      enforceSalesDocumentOptimisticLock(ctx, quote, SALES_RESOURCE_KIND_QUOTE);
       const snapshot = await loadQuoteSnapshot(em, payload.quoteId);
       if (!snapshot)
         throw new CrudHttpError(404, {
@@ -6453,6 +6475,7 @@ const orderLineUpsertCommand: CommandHandler<
     if (!order)
       throw new CrudHttpError(404, { error: "Sales order not found" });
     ensureOrderScope(ctx, order.organizationId, order.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER);
 
     const [existingLines, adjustments] = await Promise.all([
       em.find(SalesOrderLine, { order }, { orderBy: { lineNumber: "asc" } }),
@@ -6773,6 +6796,7 @@ const orderLineDeleteCommand: CommandHandler<
         ),
       });
     ensureOrderScope(ctx, order.organizationId, order.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER);
     const shipmentCount = await em.count(SalesShipmentItem, {
       orderLine: parsed.id,
       shipment: { deletedAt: null },
@@ -6943,6 +6967,7 @@ const quoteLineUpsertCommand: CommandHandler<
     if (!quote)
       throw new CrudHttpError(404, { error: "Sales quote not found" });
     ensureQuoteScope(ctx, quote.organizationId, quote.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, quote, SALES_RESOURCE_KIND_QUOTE);
     const [existingLines, adjustments] = await Promise.all([
       em.find(SalesQuoteLine, { quote }, { orderBy: { lineNumber: "asc" } }),
       em.find(
@@ -7254,6 +7279,7 @@ const quoteLineDeleteCommand: CommandHandler<
     if (!quote)
       throw new CrudHttpError(404, { error: "Sales quote not found" });
     ensureQuoteScope(ctx, quote.organizationId, quote.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, quote, SALES_RESOURCE_KIND_QUOTE);
     const existingLines = await em.find(
       SalesQuoteLine,
       { quote },
@@ -7407,6 +7433,7 @@ const orderAdjustmentUpsertCommand: CommandHandler<
     if (!order)
       throw new CrudHttpError(404, { error: "Sales order not found" });
     ensureOrderScope(ctx, order.organizationId, order.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER);
     if (parsed.scope === "line") {
       throw new CrudHttpError(400, {
         error: "Line-scoped adjustments are not supported yet.",
@@ -7700,6 +7727,7 @@ const orderAdjustmentDeleteCommand: CommandHandler<
     if (!order)
       throw new CrudHttpError(404, { error: "Sales order not found" });
     ensureOrderScope(ctx, order.organizationId, order.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER);
 
     const [existingLines, adjustments] = await Promise.all([
       em.find(SalesOrderLine, { order }, { orderBy: { lineNumber: "asc" } }),
@@ -7864,6 +7892,7 @@ const quoteAdjustmentUpsertCommand: CommandHandler<
     if (!quote)
       throw new CrudHttpError(404, { error: "Sales quote not found" });
     ensureQuoteScope(ctx, quote.organizationId, quote.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, quote, SALES_RESOURCE_KIND_QUOTE);
     if (parsed.scope === "line") {
       throw new CrudHttpError(400, {
         error: "Line-scoped adjustments are not supported yet.",
@@ -8155,6 +8184,7 @@ const quoteAdjustmentDeleteCommand: CommandHandler<
     if (!quote)
       throw new CrudHttpError(404, { error: "Sales quote not found" });
     ensureQuoteScope(ctx, quote.organizationId, quote.tenantId);
+    enforceSalesDocumentOptimisticLock(ctx, quote, SALES_RESOURCE_KIND_QUOTE);
 
     const [existingLines, adjustments] = await Promise.all([
       em.find(SalesQuoteLine, { quote }, { orderBy: { lineNumber: "asc" } }),
@@ -8334,6 +8364,7 @@ const createInvoiceCommand: CommandHandler<
     const status = await resolveDictionaryEntryValue(
       em,
       parsed.statusEntryId ?? null,
+      { tenantId: parsed.tenantId },
     );
 
     // Validate orderId belongs to same org/tenant
@@ -8545,7 +8576,7 @@ const updateInvoiceCommand: CommandHandler<
     ]);
 
     if (parsed.statusEntryId !== undefined) {
-      invoice.status = await resolveDictionaryEntryValue(em, parsed.statusEntryId ?? null);
+      invoice.status = await resolveDictionaryEntryValue(em, parsed.statusEntryId ?? null, { tenantId: invoice.tenantId });
     }
 
     Object.assign(invoice, changes);
@@ -8819,6 +8850,7 @@ const createCreditMemoCommand: CommandHandler<
     const status = await resolveDictionaryEntryValue(
       em,
       parsed.statusEntryId ?? null,
+      { tenantId: parsed.tenantId },
     );
 
     // Validate orderId belongs to same org/tenant
@@ -9035,7 +9067,7 @@ const updateCreditMemoCommand: CommandHandler<
     ]);
 
     if (parsed.statusEntryId !== undefined) {
-      creditMemo.status = await resolveDictionaryEntryValue(em, parsed.statusEntryId ?? null);
+      creditMemo.status = await resolveDictionaryEntryValue(em, parsed.statusEntryId ?? null, { tenantId: creditMemo.tenantId });
     }
 
     Object.assign(creditMemo, changes);

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

@@ -25,6 +25,8 @@ import {
   type NoteCreateInput,
   type NoteUpdateInput,
 } from '../data/validators'
+import { makeCreateRedo } from '@open-mercato/shared/lib/commands/redo'
+import { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
 import { ensureOrganizationScope, ensureSameScope, ensureTenantScope, extractUndoPayload } from './shared'
 
 type NoteSnapshot = {
@@ -220,6 +222,43 @@ const createNoteCommand: CommandHandler<NoteCreateInput, { noteId: string; autho
       await em.flush()
     }
   },
+  redo: makeCreateRedo<SalesNote, NoteSnapshot, NoteCreateInput, { noteId: string; authorUserId: string | null }>({
+    entityClass: SalesNote,
+    indexer: noteCrudIndexer,
+    events: noteCrudEvents,
+    findRow: ({ em, id, snapshot }) =>
+      findOneWithDecryption(
+        em,
+        SalesNote,
+        { id },
+        undefined,
+        { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },
+      ),
+    seedFromSnapshot: (snapshot) => ({
+      id: snapshot.id,
+      organizationId: snapshot.organizationId,
+      tenantId: snapshot.tenantId,
+      contextType: snapshot.contextType,
+      contextId: snapshot.contextId,
+      body: snapshot.body,
+      authorUserId: snapshot.authorUserId,
+      appearanceIcon: snapshot.appearanceIcon,
+      appearanceColor: snapshot.appearanceColor,
+      createdAt: new Date(),
+      updatedAt: new Date(),
+    }),
+    beforeRestore: async ({ em, snapshot }) => {
+      const context = await requireContext(em, snapshot.contextType, snapshot.contextId).catch(() => null)
+      if (!context) {
+        throw new CrudHttpError(404, { error: 'sales.notes.context_not_found' })
+      }
+      return {
+        order: snapshot.orderId ? context.order ?? null : null,
+        quote: snapshot.quoteId ? context.quote ?? null : null,
+      }
+    },
+    buildResult: (entity) => ({ noteId: entity.id, authorUserId: entity.authorUserId ?? null }),
+  }),
 }
 
 const updateNoteCommand: CommandHandler<NoteUpdateInput, { noteId: string }> = {