@open-mercato/core 0.6.2-develop.3330.1.8ad2b3b84c → 0.6.2-develop.3366.1.4692954e44

package/src/modules/sync_excel/api/upload/route.ts

@@ -0,0 +1,144 @@
+import { randomUUID } from 'crypto'
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { NextResponse } from 'next/server'
+import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
+import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
+import { z } from 'zod'
+import { syncExcelUploadResponseSchema, syncExcelEntityTypeSchema } from '../../data/validators'
+import { SyncExcelUpload } from '../../data/entities'
+import { buildSuggestedMapping } from '../../lib/mapping'
+import { parseCsvPreview } from '../../lib/parser'
+import { createSyncExcelUploadAttachment } from '../../lib/upload-storage'
+import { resolveSyncExcelConcreteScope } from '../../lib/scope'
+import { isMultipartRequestWithinUploadLimit, resolveDefaultAttachmentMaxUploadBytes } from '../../../attachments/lib/upload-limits'
+
+export const metadata = {
+  POST: { requireAuth: true, requireFeatures: ['sync_excel.run'] },
+}
+
+const multipartSchema = z.object({
+  entityType: syncExcelEntityTypeSchema.default('customers.person'),
+})
+
+const errorSchema = z.object({
+  error: z.string(),
+})
+
+export const openApi = {
+  tags: ['SyncExcel'],
+  summary: 'Upload CSV file for sync_excel preview',
+  methods: {
+    POST: {
+      summary: 'Upload CSV file',
+      requestBody: {
+        contentType: 'multipart/form-data',
+      },
+      responses: [
+        { status: 200, description: 'CSV uploaded and preview parsed', schema: syncExcelUploadResponseSchema },
+      ],
+      errors: [
+        { status: 400, description: 'Invalid multipart payload', schema: errorSchema },
+        { status: 401, description: 'Unauthorized', schema: errorSchema },
+        { status: 413, description: 'CSV upload exceeds the maximum upload size', schema: errorSchema },
+        { status: 422, description: 'Unsupported entity type or file type', schema: errorSchema },
+      ],
+    },
+  },
+}
+
+export async function POST(request: Request) {
+  const auth = await getAuthFromRequest(request)
+  if (!auth?.tenantId) {
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
+  }
+
+  const container = await createRequestContainer()
+  const scopeResult = await resolveSyncExcelConcreteScope({ auth, container, request })
+  if (!scopeResult.ok) {
+    return NextResponse.json({ error: scopeResult.error }, { status: scopeResult.status })
+  }
+  const { scope } = scopeResult
+
+  const contentType = request.headers.get('content-type') || ''
+  if (!contentType.toLowerCase().includes('multipart/form-data')) {
+    return NextResponse.json({ error: 'Expected multipart/form-data' }, { status: 400 })
+  }
+  if (!isMultipartRequestWithinUploadLimit(request.headers.get('content-length'))) {
+    return NextResponse.json({ error: 'CSV upload exceeds the maximum upload size.' }, { status: 413 })
+  }
+
+  const formData = await request.formData()
+  const parsedPayload = multipartSchema.safeParse({
+    entityType: typeof formData.get('entityType') === 'string' ? formData.get('entityType') : undefined,
+  })
+
+  if (!parsedPayload.success) {
+    return NextResponse.json({ error: 'Invalid upload payload.' }, { status: 422 })
+  }
+
+  const file = formData.get('file')
+  if (!(file instanceof File)) {
+    return NextResponse.json({ error: 'Select a CSV file to upload.' }, { status: 400 })
+  }
+
+  const supportedMimeTypes = new Set(['text/csv', 'application/vnd.ms-excel', 'application/csv'])
+  const isCsvByMime = supportedMimeTypes.has(file.type)
+  const isCsvByName = file.name.toLowerCase().endsWith('.csv')
+
+  if (!isCsvByMime && !isCsvByName) {
+    return NextResponse.json({ error: 'Only CSV uploads are supported in this foundation slice.' }, { status: 422 })
+  }
+
+  const maxUploadBytes = resolveDefaultAttachmentMaxUploadBytes()
+  if (file.size > maxUploadBytes) {
+    return NextResponse.json({ error: 'CSV upload exceeds the maximum upload size.' }, { status: 413 })
+  }
+
+  const fileBuffer = Buffer.from(await file.arrayBuffer())
+  const preview = parseCsvPreview(fileBuffer, { maxRows: 5 })
+  const suggestedMapping = buildSuggestedMapping(parsedPayload.data.entityType, preview.headers)
+
+  const em = container.resolve('em') as EntityManager
+  const uploadId = randomUUID()
+  const attachment = await createSyncExcelUploadAttachment({
+    em,
+    uploadId,
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+    fileName: file.name,
+    mimeType: file.type || 'text/csv',
+    buffer: fileBuffer,
+  })
+
+  const upload = em.create(SyncExcelUpload, {
+    id: uploadId,
+    attachmentId: attachment.id,
+    filename: file.name,
+    mimeType: file.type || 'text/csv',
+    fileSize: fileBuffer.length,
+    entityType: parsedPayload.data.entityType,
+    delimiter: preview.delimiter,
+    encoding: preview.encoding,
+    headers: preview.headers,
+    sampleRows: preview.sampleRows,
+    totalRows: preview.totalRows,
+    status: 'uploaded',
+    organizationId: scope.organizationId,
+    tenantId: scope.tenantId,
+  })
+
+  em.persist(upload)
+  await em.flush()
+
+  return NextResponse.json(syncExcelUploadResponseSchema.parse({
+    uploadId: upload.id,
+    filename: upload.filename,
+    mimeType: upload.mimeType,
+    fileSize: upload.fileSize,
+    entityType: upload.entityType,
+    headers: upload.headers,
+    sampleRows: upload.sampleRows,
+    totalRows: upload.totalRows,
+    suggestedMapping,
+  }))
+}

package/src/modules/sync_excel/data/entities.ts

@@ -0,0 +1,61 @@
+import { OptionalProps } from '@mikro-orm/core'
+import { Entity, Index, PrimaryKey, Property } from '@mikro-orm/decorators/legacy'
+
+export type SyncExcelUploadStatus = 'uploaded' | 'previewed' | 'importing' | 'completed' | 'failed'
+
+@Entity({ tableName: 'sync_excel_uploads' })
+@Index({ properties: ['organizationId', 'tenantId', 'status'] })
+export class SyncExcelUpload {
+  [OptionalProps]?: 'delimiter' | 'encoding' | 'status' | 'syncRunId' | 'createdAt' | 'updatedAt'
+
+  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })
+  id!: string
+
+  @Property({ name: 'attachment_id', type: 'uuid' })
+  attachmentId!: string
+
+  @Property({ name: 'filename', type: 'text' })
+  filename!: string
+
+  @Property({ name: 'mime_type', type: 'text' })
+  mimeType!: string
+
+  @Property({ name: 'file_size', type: 'int' })
+  fileSize!: number
+
+  @Property({ name: 'entity_type', type: 'text' })
+  entityType!: string
+
+  @Property({ name: 'delimiter', type: 'text', nullable: true })
+  delimiter?: string | null
+
+  @Property({ name: 'encoding', type: 'text', nullable: true })
+  encoding?: string | null
+
+  @Property({ name: 'headers', type: 'json' })
+  headers!: string[]
+
+  @Property({ name: 'sample_rows', type: 'json' })
+  sampleRows!: Array<Record<string, string | null>>
+
+  @Property({ name: 'total_rows', type: 'int' })
+  totalRows!: number
+
+  @Property({ name: 'status', type: 'text', default: 'uploaded' })
+  status: SyncExcelUploadStatus = 'uploaded'
+
+  @Property({ name: 'sync_run_id', type: 'uuid', nullable: true })
+  syncRunId?: string | null
+
+  @Property({ name: 'organization_id', type: 'uuid' })
+  organizationId!: string
+
+  @Property({ name: 'tenant_id', type: 'uuid' })
+  tenantId!: string
+
+  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })
+  createdAt: Date = new Date()
+
+  @Property({ name: 'updated_at', type: Date, onUpdate: () => new Date() })
+  updatedAt: Date = new Date()
+}

package/src/modules/sync_excel/data/validators.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod'
+
+export const syncExcelEntityTypes = ['customers.person'] as const
+
+export const syncExcelEntityTypeSchema = z.enum(syncExcelEntityTypes)
+
+export const syncExcelPreviewRowSchema = z.record(z.string(), z.string().nullable())
+
+export const syncExcelSuggestedFieldSchema = z.object({
+  externalField: z.string().min(1),
+  localField: z.string().min(1),
+  transform: z.string().optional(),
+  required: z.boolean().optional(),
+  defaultValue: z.unknown().optional(),
+  mappingKind: z.enum(['core', 'relation', 'external_id', 'custom_field', 'metadata', 'ignore']).optional(),
+  dedupeRole: z.enum(['primary', 'secondary']).optional(),
+})
+
+export const syncExcelSuggestedMappingSchema = z.object({
+  entityType: syncExcelEntityTypeSchema,
+  matchStrategy: z.enum(['externalId', 'email', 'custom']),
+  matchField: z.string().optional(),
+  fields: z.array(syncExcelSuggestedFieldSchema),
+  unmappedColumns: z.array(z.string()),
+})
+
+export const syncExcelUploadResponseSchema = z.object({
+  uploadId: z.string().uuid(),
+  filename: z.string().min(1),
+  mimeType: z.string().min(1),
+  fileSize: z.number().int().nonnegative(),
+  entityType: syncExcelEntityTypeSchema,
+  headers: z.array(z.string()),
+  sampleRows: z.array(syncExcelPreviewRowSchema),
+  totalRows: z.number().int().nonnegative(),
+  suggestedMapping: syncExcelSuggestedMappingSchema,
+})
+
+export const syncExcelPreviewQuerySchema = z.object({
+  uploadId: z.string().uuid(),
+  entityType: syncExcelEntityTypeSchema.optional(),
+})
+
+export const syncExcelImportRequestSchema = z.object({
+  uploadId: z.string().uuid(),
+  entityType: syncExcelEntityTypeSchema,
+  mapping: syncExcelSuggestedMappingSchema,
+  batchSize: z.number().int().min(1).max(1000).default(100).optional(),
+})
+
+export const syncExcelImportResponseSchema = z.object({
+  runId: z.string().uuid(),
+  progressJobId: z.string().uuid().nullable(),
+  status: z.enum(['pending', 'running', 'completed', 'failed', 'cancelled']),
+})
+
+export type SyncExcelPreviewQuery = z.infer<typeof syncExcelPreviewQuerySchema>
+export type SyncExcelImportRequest = z.infer<typeof syncExcelImportRequestSchema>

package/src/modules/sync_excel/di.ts

@@ -0,0 +1,9 @@
+import type { AppContainer } from '@open-mercato/shared/lib/di/container'
+import { registerDataSyncAdapter } from '../data_sync/lib/adapter-registry'
+import { syncExcelCustomersAdapter } from './lib/adapters/customers'
+
+export function register(_container: AppContainer) {
+  registerDataSyncAdapter(syncExcelCustomersAdapter)
+}
+
+export default register

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

@@ -0,0 +1,107 @@
+{
+  "sync_excel.integration.description": "Upload CSV files, preview mappings, and run file-based imports through Data Sync.",
+  "sync_excel.integration.title": "Excel / CSV Import",
+  "sync_excel.mapping.targets.addressCompanyName": "Address company",
+  "sync_excel.mapping.targets.addressLine1": "Address line 1",
+  "sync_excel.mapping.targets.addressLine2": "Address line 2",
+  "sync_excel.mapping.targets.addressName": "Address label",
+  "sync_excel.mapping.targets.addressPurpose": "Address purpose",
+  "sync_excel.mapping.targets.buildingNumber": "Building number",
+  "sync_excel.mapping.targets.city": "City",
+  "sync_excel.mapping.targets.country": "Country",
+  "sync_excel.mapping.targets.description": "Description",
+  "sync_excel.mapping.targets.displayName": "Display name",
+  "sync_excel.mapping.targets.externalId": "External ID",
+  "sync_excel.mapping.targets.firstName": "First name",
+  "sync_excel.mapping.targets.flatNumber": "Flat number",
+  "sync_excel.mapping.targets.ignore": "Leave unmapped",
+  "sync_excel.mapping.targets.jobTitle": "Job title",
+  "sync_excel.mapping.targets.lastName": "Last name",
+  "sync_excel.mapping.targets.latitude": "Latitude",
+  "sync_excel.mapping.targets.longitude": "Longitude",
+  "sync_excel.mapping.targets.postalCode": "Postal code",
+  "sync_excel.mapping.targets.primaryEmail": "Primary email",
+  "sync_excel.mapping.targets.primaryPhone": "Primary phone",
+  "sync_excel.mapping.targets.region": "Region / State",
+  "sync_excel.mapping.targets.source": "Source",
+  "sync_excel.mapping.targets.status": "Status",
+  "sync_excel.preview.errors.notFound": "Upload preview not found.",
+  "sync_excel.tabs.import": "Import CSV",
+  "sync_excel.upload.errors.fileRequired": "Select a CSV file to upload.",
+  "sync_excel.upload.errors.invalidPayload": "Invalid upload payload.",
+  "sync_excel.upload.errors.invalidType": "Only CSV uploads are supported in this foundation slice.",
+  "sync_excel.widget.actions.cancel": "Cancel run",
+  "sync_excel.widget.actions.cancelPending": "Cancelling...",
+  "sync_excel.widget.actions.refresh": "Refresh preview",
+  "sync_excel.widget.actions.refreshPending": "Refreshing...",
+  "sync_excel.widget.actions.refreshRun": "Refresh run status",
+  "sync_excel.widget.actions.reset": "Reset to suggestion",
+  "sync_excel.widget.actions.start": "Start import",
+  "sync_excel.widget.actions.startPending": "Starting...",
+  "sync_excel.widget.actions.upload": "Upload and preview",
+  "sync_excel.widget.actions.uploadPending": "Uploading...",
+  "sync_excel.widget.disabled.message": "Enable this integration to upload CSV files and start imports.",
+  "sync_excel.widget.disabled.title": "Integration disabled",
+  "sync_excel.widget.mapping.sampleValue": "Sample value",
+  "sync_excel.widget.mapping.sourceColumn": "Source column",
+  "sync_excel.widget.mapping.targetField": "Target field",
+  "sync_excel.widget.matchStrategy.custom": "Custom matching",
+  "sync_excel.widget.matchStrategy.customDescription": "Advanced option. Use only if you know how existing records should be identified in this import.",
+  "sync_excel.widget.matchStrategy.customWarningMessage": "Custom matching may create duplicates if the mapped fields do not uniquely identify a person.",
+  "sync_excel.widget.matchStrategy.customWarningTitle": "Use custom matching with care",
+  "sync_excel.widget.matchStrategy.email": "Email address",
+  "sync_excel.widget.matchStrategy.emailDescription": "Matches people by email. Works best when each person has one reliable, unique email address.",
+  "sync_excel.widget.matchStrategy.externalId": "Source record ID (Recommended)",
+  "sync_excel.widget.matchStrategy.externalIdDescription": "Best for repeated imports from the same source. Future imports update the same people instead of creating duplicates.",
+  "sync_excel.widget.matchStrategy.help": "This decides whether imported rows update existing people or create new ones.",
+  "sync_excel.widget.matchStrategy.label": "How to match existing people",
+  "sync_excel.widget.messages.cancelError": "Failed to cancel import run.",
+  "sync_excel.widget.messages.cancelSuccess": "Import run cancelled.",
+  "sync_excel.widget.messages.fileRequired": "Select a CSV file first.",
+  "sync_excel.widget.messages.importError": "Failed to start import run.",
+  "sync_excel.widget.messages.importStarted": "Import run started.",
+  "sync_excel.widget.messages.mappingReset": "Suggested mapping restored.",
+  "sync_excel.widget.messages.previewError": "Failed to refresh preview.",
+  "sync_excel.widget.messages.previewRefreshed": "Preview refreshed.",
+  "sync_excel.widget.messages.restoringSession": "Letzte CSV-Sitzung wird wiederhergestellt...",
+  "sync_excel.widget.messages.uploadError": "Failed to upload CSV file.",
+  "sync_excel.widget.messages.uploadSuccess": "CSV preview is ready.",
+  "sync_excel.widget.metrics.entity": "Target entity",
+  "sync_excel.widget.metrics.identity": "Identity strategy",
+  "sync_excel.widget.metrics.mapped": "Mapped columns",
+  "sync_excel.widget.metrics.unmapped": "Unmapped columns",
+  "sync_excel.widget.preview.description": "Every source column stays visible here. Leave a target empty to keep the column unmapped for now.",
+  "sync_excel.widget.preview.rows": "{count} rows",
+  "sync_excel.widget.preview.title": "Preview and mapping",
+  "sync_excel.widget.run.description": "The import runs in the background through Data Sync and updates this view as progress changes.",
+  "sync_excel.widget.run.errorTitle": "Run error",
+  "sync_excel.widget.run.metrics.created": "Created",
+  "sync_excel.widget.run.metrics.failed": "Failed",
+  "sync_excel.widget.run.metrics.processed": "Processed",
+  "sync_excel.widget.run.metrics.skipped": "Skipped",
+  "sync_excel.widget.run.metrics.updated": "Updated",
+  "sync_excel.widget.run.progressLabel": "Progress",
+  "sync_excel.widget.run.status.cancelled": "Cancelled",
+  "sync_excel.widget.run.status.completed": "Completed",
+  "sync_excel.widget.run.status.failed": "Failed",
+  "sync_excel.widget.run.status.idle": "Idle",
+  "sync_excel.widget.run.status.pending": "Pending",
+  "sync_excel.widget.run.status.running": "Running",
+  "sync_excel.widget.run.title": "Import run status",
+  "sync_excel.widget.upload.description": "Upload a CSV file, review the suggested people mapping, and start a background import run.",
+  "sync_excel.widget.upload.fileLabel": "CSV file",
+  "sync_excel.widget.upload.selectedFile": "Selected file",
+  "sync_excel.widget.upload.title": "Upload CSV",
+  "sync_excel.widget.validation.duplicateRiskMessage": "Diese Zuordnung verwendet nicht die empfohlene Strategie Externe ID oder E-Mail. Ein erneuter Import desselben Datensatzes kann doppelte Personen erzeugen.",
+  "sync_excel.widget.validation.duplicateRiskTitle": "Risiko von Duplikaten",
+  "sync_excel.widget.validation.duplicateTargetsMessage": "Each target field can only be mapped once in this foundation slice: {targets}",
+  "sync_excel.widget.validation.duplicateTargetsTitle": "Duplicate target fields",
+  "sync_excel.widget.validation.identityMessage": "Map either External ID or Primary email so reimports can match existing people.",
+  "sync_excel.widget.validation.identityTitle": "Map an identity field",
+  "sync_excel.widget.validation.nameMessage": "Map Last name or Display name so the importer can build person records.",
+  "sync_excel.widget.validation.nameTitle": "Map a name field",
+  "sync_excel.widget.validation.readyMessage": "The current mapping is valid for the first customers.person slice.",
+  "sync_excel.widget.validation.readyTitle": "Ready to import",
+  "sync_excel.widget.validation.reimportMessage": "Ein weiterer Import aus derselben hochgeladenen CSV kann Duplikate erzeugen, wenn die Abgleichstrategie bestehende Personen nicht zuverlässig erkennt.",
+  "sync_excel.widget.validation.reimportTitle": "Für diesen Upload gibt es bereits einen Lauf"
+}

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

@@ -0,0 +1,107 @@
+{
+  "sync_excel.integration.description": "Upload CSV files, preview mappings, and run file-based imports through Data Sync.",
+  "sync_excel.integration.title": "Excel / CSV Import",
+  "sync_excel.mapping.targets.addressCompanyName": "Address company",
+  "sync_excel.mapping.targets.addressLine1": "Address line 1",
+  "sync_excel.mapping.targets.addressLine2": "Address line 2",
+  "sync_excel.mapping.targets.addressName": "Address label",
+  "sync_excel.mapping.targets.addressPurpose": "Address purpose",
+  "sync_excel.mapping.targets.buildingNumber": "Building number",
+  "sync_excel.mapping.targets.city": "City",
+  "sync_excel.mapping.targets.country": "Country",
+  "sync_excel.mapping.targets.description": "Description",
+  "sync_excel.mapping.targets.displayName": "Display name",
+  "sync_excel.mapping.targets.externalId": "External ID",
+  "sync_excel.mapping.targets.firstName": "First name",
+  "sync_excel.mapping.targets.flatNumber": "Flat number",
+  "sync_excel.mapping.targets.ignore": "Leave unmapped",
+  "sync_excel.mapping.targets.jobTitle": "Job title",
+  "sync_excel.mapping.targets.lastName": "Last name",
+  "sync_excel.mapping.targets.latitude": "Latitude",
+  "sync_excel.mapping.targets.longitude": "Longitude",
+  "sync_excel.mapping.targets.postalCode": "Postal code",
+  "sync_excel.mapping.targets.primaryEmail": "Primary email",
+  "sync_excel.mapping.targets.primaryPhone": "Primary phone",
+  "sync_excel.mapping.targets.region": "Region / State",
+  "sync_excel.mapping.targets.source": "Source",
+  "sync_excel.mapping.targets.status": "Status",
+  "sync_excel.preview.errors.notFound": "Upload preview not found.",
+  "sync_excel.tabs.import": "Import CSV",
+  "sync_excel.upload.errors.fileRequired": "Select a CSV file to upload.",
+  "sync_excel.upload.errors.invalidPayload": "Invalid upload payload.",
+  "sync_excel.upload.errors.invalidType": "Only CSV uploads are supported in this foundation slice.",
+  "sync_excel.widget.actions.cancel": "Cancel run",
+  "sync_excel.widget.actions.cancelPending": "Cancelling...",
+  "sync_excel.widget.actions.refresh": "Refresh preview",
+  "sync_excel.widget.actions.refreshPending": "Refreshing...",
+  "sync_excel.widget.actions.refreshRun": "Refresh run status",
+  "sync_excel.widget.actions.reset": "Reset to suggestion",
+  "sync_excel.widget.actions.start": "Start import",
+  "sync_excel.widget.actions.startPending": "Starting...",
+  "sync_excel.widget.actions.upload": "Upload and preview",
+  "sync_excel.widget.actions.uploadPending": "Uploading...",
+  "sync_excel.widget.disabled.message": "Enable this integration to upload CSV files and start imports.",
+  "sync_excel.widget.disabled.title": "Integration disabled",
+  "sync_excel.widget.mapping.sampleValue": "Sample value",
+  "sync_excel.widget.mapping.sourceColumn": "Source column",
+  "sync_excel.widget.mapping.targetField": "Target field",
+  "sync_excel.widget.matchStrategy.custom": "Custom matching",
+  "sync_excel.widget.matchStrategy.customDescription": "Advanced option. Use only if you know how existing records should be identified in this import.",
+  "sync_excel.widget.matchStrategy.customWarningMessage": "Custom matching may create duplicates if the mapped fields do not uniquely identify a person.",
+  "sync_excel.widget.matchStrategy.customWarningTitle": "Use custom matching with care",
+  "sync_excel.widget.matchStrategy.email": "Email address",
+  "sync_excel.widget.matchStrategy.emailDescription": "Matches people by email. Works best when each person has one reliable, unique email address.",
+  "sync_excel.widget.matchStrategy.externalId": "Source record ID (Recommended)",
+  "sync_excel.widget.matchStrategy.externalIdDescription": "Best for repeated imports from the same source. Future imports update the same people instead of creating duplicates.",
+  "sync_excel.widget.matchStrategy.help": "This decides whether imported rows update existing people or create new ones.",
+  "sync_excel.widget.matchStrategy.label": "How to match existing people",
+  "sync_excel.widget.messages.cancelError": "Failed to cancel import run.",
+  "sync_excel.widget.messages.cancelSuccess": "Import run cancelled.",
+  "sync_excel.widget.messages.fileRequired": "Select a CSV file first.",
+  "sync_excel.widget.messages.importError": "Failed to start import run.",
+  "sync_excel.widget.messages.importStarted": "Import run started.",
+  "sync_excel.widget.messages.mappingReset": "Suggested mapping restored.",
+  "sync_excel.widget.messages.previewError": "Failed to refresh preview.",
+  "sync_excel.widget.messages.previewRefreshed": "Preview refreshed.",
+  "sync_excel.widget.messages.restoringSession": "Restoring the last CSV session...",
+  "sync_excel.widget.messages.uploadError": "Failed to upload CSV file.",
+  "sync_excel.widget.messages.uploadSuccess": "CSV preview is ready.",
+  "sync_excel.widget.metrics.entity": "Target entity",
+  "sync_excel.widget.metrics.identity": "Identity strategy",
+  "sync_excel.widget.metrics.mapped": "Mapped columns",
+  "sync_excel.widget.metrics.unmapped": "Unmapped columns",
+  "sync_excel.widget.preview.description": "Every source column stays visible here. Leave a target empty to keep the column unmapped for now.",
+  "sync_excel.widget.preview.rows": "{count} rows",
+  "sync_excel.widget.preview.title": "Preview and mapping",
+  "sync_excel.widget.run.description": "The import runs in the background through Data Sync and updates this view as progress changes.",
+  "sync_excel.widget.run.errorTitle": "Run error",
+  "sync_excel.widget.run.metrics.created": "Created",
+  "sync_excel.widget.run.metrics.failed": "Failed",
+  "sync_excel.widget.run.metrics.processed": "Processed",
+  "sync_excel.widget.run.metrics.skipped": "Skipped",
+  "sync_excel.widget.run.metrics.updated": "Updated",
+  "sync_excel.widget.run.progressLabel": "Progress",
+  "sync_excel.widget.run.status.cancelled": "Cancelled",
+  "sync_excel.widget.run.status.completed": "Completed",
+  "sync_excel.widget.run.status.failed": "Failed",
+  "sync_excel.widget.run.status.idle": "Idle",
+  "sync_excel.widget.run.status.pending": "Pending",
+  "sync_excel.widget.run.status.running": "Running",
+  "sync_excel.widget.run.title": "Import run status",
+  "sync_excel.widget.upload.description": "Upload a CSV file, review the suggested people mapping, and start a background import run.",
+  "sync_excel.widget.upload.fileLabel": "CSV file",
+  "sync_excel.widget.upload.selectedFile": "Selected file",
+  "sync_excel.widget.upload.title": "Upload CSV",
+  "sync_excel.widget.validation.duplicateRiskMessage": "This mapping does not use the recommended External ID or Email matching strategy. Re-importing the same dataset may create duplicate people.",
+  "sync_excel.widget.validation.duplicateRiskTitle": "Duplicate risk",
+  "sync_excel.widget.validation.duplicateTargetsMessage": "Each target field can only be mapped once in this foundation slice: {targets}",
+  "sync_excel.widget.validation.duplicateTargetsTitle": "Duplicate target fields",
+  "sync_excel.widget.validation.identityMessage": "Map either External ID or Primary email so reimports can match existing people.",
+  "sync_excel.widget.validation.identityTitle": "Map an identity field",
+  "sync_excel.widget.validation.nameMessage": "Map Last name or Display name so the importer can build person records.",
+  "sync_excel.widget.validation.nameTitle": "Map a name field",
+  "sync_excel.widget.validation.readyMessage": "The current mapping is valid for the first customers.person slice.",
+  "sync_excel.widget.validation.readyTitle": "Ready to import",
+  "sync_excel.widget.validation.reimportMessage": "Starting another import from the same uploaded CSV may create duplicates unless your matching strategy reliably identifies existing people.",
+  "sync_excel.widget.validation.reimportTitle": "This upload already has a run"
+}

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

@@ -0,0 +1,107 @@
+{
+  "sync_excel.integration.description": "Upload CSV files, preview mappings, and run file-based imports through Data Sync.",
+  "sync_excel.integration.title": "Excel / CSV Import",
+  "sync_excel.mapping.targets.addressCompanyName": "Address company",
+  "sync_excel.mapping.targets.addressLine1": "Address line 1",
+  "sync_excel.mapping.targets.addressLine2": "Address line 2",
+  "sync_excel.mapping.targets.addressName": "Address label",
+  "sync_excel.mapping.targets.addressPurpose": "Address purpose",
+  "sync_excel.mapping.targets.buildingNumber": "Building number",
+  "sync_excel.mapping.targets.city": "City",
+  "sync_excel.mapping.targets.country": "Country",
+  "sync_excel.mapping.targets.description": "Description",
+  "sync_excel.mapping.targets.displayName": "Display name",
+  "sync_excel.mapping.targets.externalId": "External ID",
+  "sync_excel.mapping.targets.firstName": "First name",
+  "sync_excel.mapping.targets.flatNumber": "Flat number",
+  "sync_excel.mapping.targets.ignore": "Leave unmapped",
+  "sync_excel.mapping.targets.jobTitle": "Job title",
+  "sync_excel.mapping.targets.lastName": "Last name",
+  "sync_excel.mapping.targets.latitude": "Latitude",
+  "sync_excel.mapping.targets.longitude": "Longitude",
+  "sync_excel.mapping.targets.postalCode": "Postal code",
+  "sync_excel.mapping.targets.primaryEmail": "Primary email",
+  "sync_excel.mapping.targets.primaryPhone": "Primary phone",
+  "sync_excel.mapping.targets.region": "Region / State",
+  "sync_excel.mapping.targets.source": "Source",
+  "sync_excel.mapping.targets.status": "Status",
+  "sync_excel.preview.errors.notFound": "Upload preview not found.",
+  "sync_excel.tabs.import": "Import CSV",
+  "sync_excel.upload.errors.fileRequired": "Select a CSV file to upload.",
+  "sync_excel.upload.errors.invalidPayload": "Invalid upload payload.",
+  "sync_excel.upload.errors.invalidType": "Only CSV uploads are supported in this foundation slice.",
+  "sync_excel.widget.actions.cancel": "Cancel run",
+  "sync_excel.widget.actions.cancelPending": "Cancelling...",
+  "sync_excel.widget.actions.refresh": "Refresh preview",
+  "sync_excel.widget.actions.refreshPending": "Refreshing...",
+  "sync_excel.widget.actions.refreshRun": "Refresh run status",
+  "sync_excel.widget.actions.reset": "Reset to suggestion",
+  "sync_excel.widget.actions.start": "Start import",
+  "sync_excel.widget.actions.startPending": "Starting...",
+  "sync_excel.widget.actions.upload": "Upload and preview",
+  "sync_excel.widget.actions.uploadPending": "Uploading...",
+  "sync_excel.widget.disabled.message": "Enable this integration to upload CSV files and start imports.",
+  "sync_excel.widget.disabled.title": "Integration disabled",
+  "sync_excel.widget.mapping.sampleValue": "Sample value",
+  "sync_excel.widget.mapping.sourceColumn": "Source column",
+  "sync_excel.widget.mapping.targetField": "Target field",
+  "sync_excel.widget.matchStrategy.custom": "Custom matching",
+  "sync_excel.widget.matchStrategy.customDescription": "Advanced option. Use only if you know how existing records should be identified in this import.",
+  "sync_excel.widget.matchStrategy.customWarningMessage": "Custom matching may create duplicates if the mapped fields do not uniquely identify a person.",
+  "sync_excel.widget.matchStrategy.customWarningTitle": "Use custom matching with care",
+  "sync_excel.widget.matchStrategy.email": "Email address",
+  "sync_excel.widget.matchStrategy.emailDescription": "Matches people by email. Works best when each person has one reliable, unique email address.",
+  "sync_excel.widget.matchStrategy.externalId": "Source record ID (Recommended)",
+  "sync_excel.widget.matchStrategy.externalIdDescription": "Best for repeated imports from the same source. Future imports update the same people instead of creating duplicates.",
+  "sync_excel.widget.matchStrategy.help": "This decides whether imported rows update existing people or create new ones.",
+  "sync_excel.widget.matchStrategy.label": "How to match existing people",
+  "sync_excel.widget.messages.cancelError": "Failed to cancel import run.",
+  "sync_excel.widget.messages.cancelSuccess": "Import run cancelled.",
+  "sync_excel.widget.messages.fileRequired": "Select a CSV file first.",
+  "sync_excel.widget.messages.importError": "Failed to start import run.",
+  "sync_excel.widget.messages.importStarted": "Import run started.",
+  "sync_excel.widget.messages.mappingReset": "Suggested mapping restored.",
+  "sync_excel.widget.messages.previewError": "Failed to refresh preview.",
+  "sync_excel.widget.messages.previewRefreshed": "Preview refreshed.",
+  "sync_excel.widget.messages.restoringSession": "Restaurando la última sesión de CSV...",
+  "sync_excel.widget.messages.uploadError": "Failed to upload CSV file.",
+  "sync_excel.widget.messages.uploadSuccess": "CSV preview is ready.",
+  "sync_excel.widget.metrics.entity": "Target entity",
+  "sync_excel.widget.metrics.identity": "Identity strategy",
+  "sync_excel.widget.metrics.mapped": "Mapped columns",
+  "sync_excel.widget.metrics.unmapped": "Unmapped columns",
+  "sync_excel.widget.preview.description": "Every source column stays visible here. Leave a target empty to keep the column unmapped for now.",
+  "sync_excel.widget.preview.rows": "{count} rows",
+  "sync_excel.widget.preview.title": "Preview and mapping",
+  "sync_excel.widget.run.description": "The import runs in the background through Data Sync and updates this view as progress changes.",
+  "sync_excel.widget.run.errorTitle": "Run error",
+  "sync_excel.widget.run.metrics.created": "Created",
+  "sync_excel.widget.run.metrics.failed": "Failed",
+  "sync_excel.widget.run.metrics.processed": "Processed",
+  "sync_excel.widget.run.metrics.skipped": "Skipped",
+  "sync_excel.widget.run.metrics.updated": "Updated",
+  "sync_excel.widget.run.progressLabel": "Progress",
+  "sync_excel.widget.run.status.cancelled": "Cancelled",
+  "sync_excel.widget.run.status.completed": "Completed",
+  "sync_excel.widget.run.status.failed": "Failed",
+  "sync_excel.widget.run.status.idle": "Idle",
+  "sync_excel.widget.run.status.pending": "Pending",
+  "sync_excel.widget.run.status.running": "Running",
+  "sync_excel.widget.run.title": "Import run status",
+  "sync_excel.widget.upload.description": "Upload a CSV file, review the suggested people mapping, and start a background import run.",
+  "sync_excel.widget.upload.fileLabel": "CSV file",
+  "sync_excel.widget.upload.selectedFile": "Selected file",
+  "sync_excel.widget.upload.title": "Upload CSV",
+  "sync_excel.widget.validation.duplicateRiskMessage": "Este mapeo no usa la estrategia recomendada de ID externo o correo electrónico. Reimportar el mismo conjunto de datos puede crear personas duplicadas.",
+  "sync_excel.widget.validation.duplicateRiskTitle": "Riesgo de duplicados",
+  "sync_excel.widget.validation.duplicateTargetsMessage": "Each target field can only be mapped once in this foundation slice: {targets}",
+  "sync_excel.widget.validation.duplicateTargetsTitle": "Duplicate target fields",
+  "sync_excel.widget.validation.identityMessage": "Map either External ID or Primary email so reimports can match existing people.",
+  "sync_excel.widget.validation.identityTitle": "Map an identity field",
+  "sync_excel.widget.validation.nameMessage": "Map Last name or Display name so the importer can build person records.",
+  "sync_excel.widget.validation.nameTitle": "Map a name field",
+  "sync_excel.widget.validation.readyMessage": "The current mapping is valid for the first customers.person slice.",
+  "sync_excel.widget.validation.readyTitle": "Ready to import",
+  "sync_excel.widget.validation.reimportMessage": "Iniciar otra importación desde el mismo CSV cargado puede crear duplicados si la estrategia de coincidencia no identifica de forma fiable a las personas existentes.",
+  "sync_excel.widget.validation.reimportTitle": "Esta carga ya tiene una ejecución"
+}