@open-mercato/core 0.6.8-develop.6983.1.e4f794099e → 0.6.8-develop.6985.1.fb93574faa

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

@@ -0,0 +1,111 @@
+import { OptionalProps } from '@mikro-orm/core'
+import { Entity, Index, PrimaryKey, Property } from '@mikro-orm/decorators/legacy'
+
+export type PushDeliveryStatus = 'pending' | 'sending' | 'sent' | 'failed' | 'skipped' | 'expired'
+
+/**
+ * Append-only delivery log for a single push notification attempt against one device.
+ *
+ * One row per (notification, device). The strategy inserts rows `pending`; the `send-push` worker
+ * atomically claims a row (`pending` → `sending`, so a redelivered job is processed once) and then
+ * transitions it to `sent`/`failed`/`skipped`, or `expired` once retries are exhausted. This is a
+ * background-job/log row, so it is intentionally EXEMPT from optimistic locking
+ * (status transitions are server-driven, never concurrently user-edited) and is
+ * NOT added to the curated `optimistic-lock-editable-entities` list.
+ *
+ * `push_token` is a secret: the full token is never persisted here — only
+ * `token_snapshot` (last 8 chars, for debugging across token rotation) plus the
+ * `provider` snapshot so the audit trail survives token rotation and device deletion.
+ */
+@Entity({ tableName: 'push_notification_deliveries' })
+@Index({ name: 'push_notification_deliveries_tenant_status_idx', properties: ['tenantId', 'status', 'createdAt'] })
+@Index({ name: 'push_notification_deliveries_notification_idx', properties: ['notificationId'] })
+// Idempotency guard for the fan-out: the `push` strategy runs inside the at-least-once persistent
+// `notifications:deliver` subscriber, so a redelivered event would otherwise insert a second set of
+// rows for the same (notification, device) → a duplicate push. A partial unique index (only where
+// notification_id is set — direct/silent pushes without a notification are out of scope) lets the
+// strategy insert-on-conflict-do-nothing, making a re-run a no-op.
+@Index({
+  name: 'push_notification_deliveries_notif_device_unique',
+  expression:
+    'create unique index "push_notification_deliveries_notif_device_unique" on "push_notification_deliveries" ("notification_id", "user_device_id") where "notification_id" is not null',
+})
+export class PushNotificationDelivery {
+  [OptionalProps]?:
+    | 'organizationId'
+    | 'notificationId'
+    | 'status'
+    | 'attempts'
+    | 'lastError'
+    | 'providerResponse'
+    | 'silent'
+    | 'createdAt'
+    | 'sentAt'
+    | 'nextRetryAt'
+    | 'updatedAt'
+
+  @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })
+  id!: string
+
+  @Property({ name: 'tenant_id', type: 'uuid' })
+  tenantId!: string
+
+  @Property({ name: 'organization_id', type: 'uuid', nullable: true })
+  organizationId?: string | null
+
+  // Soft FK -> notifications.notifications (nullable: a push can be dispatched without an in-app row).
+  @Property({ name: 'notification_id', type: 'uuid', nullable: true })
+  notificationId?: string | null
+
+  @Property({ name: 'notification_type_id', type: 'text' })
+  notificationTypeId!: string
+
+  // Soft FK -> devices.user_devices (link declared in data/extensions.ts).
+  @Property({ name: 'user_device_id', type: 'uuid' })
+  userDeviceId!: string
+
+  @Property({ name: 'user_id', type: 'uuid' })
+  userId!: string
+
+  // Snapshot of the push CommunicationChannel providerKey used at send time.
+  @Property({ name: 'provider', type: 'text' })
+  provider!: string
+
+  // Last 8 chars of the device push token only — never the full secret.
+  @Property({ name: 'token_snapshot', type: 'text' })
+  tokenSnapshot!: string
+
+  // Snapshot of whether this was a silent / content-available wake-up (derived from the
+  // notification type's `silent` flag at fan-out time) so the log distinguishes silent deliveries.
+  @Property({ name: 'silent', type: 'boolean', default: false })
+  silent: boolean = false
+
+  @Property({ name: 'status', type: 'text', default: 'pending' })
+  status: PushDeliveryStatus = 'pending'
+
+  @Property({ name: 'attempts', type: 'int', default: 0 })
+  attempts: number = 0
+
+  @Property({ name: 'last_error', type: 'text', nullable: true })
+  lastError?: string | null
+
+  @Property({ name: 'payload', type: 'json' })
+  payload!: Record<string, unknown>
+
+  @Property({ name: 'provider_response', type: 'json', nullable: true })
+  providerResponse?: Record<string, unknown> | null
+
+  @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })
+  createdAt: Date = new Date()
+
+  @Property({ name: 'sent_at', type: Date, nullable: true })
+  sentAt?: Date | null
+
+  // Set when a retryable failure re-enqueues the job (observability for the admin delivery log);
+  // cleared once the delivery reaches a terminal state.
+  @Property({ name: 'next_retry_at', type: Date, nullable: true })
+  nextRetryAt?: Date | null
+
+  @Property({ name: 'updated_at', type: Date, onCreate: () => new Date(), onUpdate: () => new Date() })
+  updatedAt: Date = new Date()
+}

package/src/modules/push_notifications/data/extensions.ts

@@ -0,0 +1,29 @@
+import type { EntityExtension } from '@open-mercato/shared/modules/entities'
+
+/**
+ * Cross-module entity links declared by the push_notifications module.
+ *
+ * Per root AGENTS.md, modules do NOT form direct ORM relationships across
+ * boundaries. `PushNotificationDelivery` carries plain UUID columns that
+ * reference rows owned by other modules; the links are declared here so the
+ * data engine + UI tooling can traverse them.
+ */
+const entityExtensions: EntityExtension[] = [
+  {
+    base: 'push_notifications:push_notification_delivery',
+    extension: 'devices:user_device',
+    join: { baseKey: 'user_device_id', extensionKey: 'id' },
+    cardinality: 'many-to-one',
+    description: 'Links a push delivery row to the target user device it was sent to',
+  },
+  {
+    base: 'push_notifications:push_notification_delivery',
+    extension: 'notifications:notification',
+    join: { baseKey: 'notification_id', extensionKey: 'id' },
+    cardinality: 'many-to-one',
+    description: 'Links a push delivery row to the in-app notification that triggered it',
+  },
+]
+
+export const extensions = entityExtensions
+export default entityExtensions

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

@@ -0,0 +1,102 @@
+import { z } from 'zod'
+import { pushOptionsSchema } from '@open-mercato/core/modules/notifications/data/validators'
+
+export const PUSH_DELIVERY_STATUSES = ['pending', 'sending', 'sent', 'failed', 'skipped', 'expired'] as const
+
+// A `created_at` range bound: an ISO-8601 date (`2026-07-01`) or datetime (`2026-07-01T00:00:00Z`).
+// Validated here so a malformed value fails with a 400 instead of reaching the query engine / Postgres.
+const rangeDateFilter = z.union([z.string().datetime({ offset: true }), z.string().date()])
+
+// POST /api/push_notifications/custom-send — admin composes a one-off visible push to a single user.
+// title/body are literal free text (not i18n keys). data/pushOptions reuse the notifications contract.
+export const customSendSchema = z
+  .object({
+    recipientUserId: z.string().uuid(),
+    // Optional: target one of the recipient's devices; omit to send to all their devices.
+    deviceId: z.string().uuid().optional(),
+    title: z.string().trim().min(1).max(500),
+    body: z.string().trim().max(2000).nullish(),
+    data: z.record(z.string(), z.string()).optional(),
+    pushOptions: pushOptionsSchema.optional(),
+    // When true, deliver a silent data-only wake-up instead of a visible banner.
+    silent: z.boolean().optional(),
+  })
+  .strict()
+export type CustomSendInput = z.infer<typeof customSendSchema>
+
+// Machine-readable warning surfaced when a well-formed send resolved no deliverable device in scope
+// (no push channel configured, no in-scope devices, or none whose provider matches an active channel).
+// The caller gets `enqueued: 0` plus this code + a human `message` instead of a misleading silent success.
+export const CUSTOM_SEND_NO_DEVICES_WARNING = 'no_matching_devices_in_scope'
+
+export const customSendResponseSchema = z.object({
+  enqueued: z.number(),
+  warning: z.literal(CUSTOM_SEND_NO_DEVICES_WARNING).optional(),
+  message: z.string().optional(),
+})
+
+// Read-only delivery-log list contract (admin observability). No full push token is ever exposed —
+// only `token_snapshot` (last 8 chars) and the `provider` snapshot.
+export const deliveryListSchema = z
+  .object({
+    page: z.coerce.number().min(1).default(1),
+    pageSize: z.coerce.number().min(1).max(100).default(50),
+    status: z.enum(PUSH_DELIVERY_STATUSES).optional(),
+    userId: z.string().uuid().optional(),
+    from: rangeDateFilter.optional(),
+    to: rangeDateFilter.optional(),
+    sortField: z.string().optional(),
+    sortDir: z.enum(['asc', 'desc']).optional(),
+  })
+  .passthrough()
+
+export const deliveryListFields: string[] = [
+  'id',
+  'tenant_id',
+  'organization_id',
+  'notification_id',
+  'notification_type_id',
+  'user_device_id',
+  'user_id',
+  'provider',
+  'token_snapshot',
+  'status',
+  'attempts',
+  'last_error',
+  'created_at',
+  'sent_at',
+  'next_retry_at',
+  'updated_at',
+]
+
+export const deliveryListSortFieldMap: Record<string, string> = {
+  createdAt: 'created_at',
+  sentAt: 'sent_at',
+  updatedAt: 'updated_at',
+  status: 'status',
+}
+
+export const deliveryListItemSchema = z.object({
+  id: z.string().uuid(),
+  tenant_id: z.string().uuid(),
+  organization_id: z.string().uuid().nullable().optional(),
+  notification_id: z.string().uuid().nullable().optional(),
+  notification_type_id: z.string(),
+  user_device_id: z.string().uuid(),
+  user_id: z.string().uuid(),
+  provider: z.string(),
+  token_snapshot: z.string(),
+  status: z.enum(PUSH_DELIVERY_STATUSES),
+  attempts: z.number(),
+  last_error: z.string().nullable().optional(),
+  created_at: z.string().nullable().optional(),
+  sent_at: z.string().nullable().optional(),
+  next_retry_at: z.string().nullable().optional(),
+  updated_at: z.string().nullable().optional(),
+})
+
+// Detail adds the JSON payload + provider response (still no full token).
+export const deliveryDetailItemSchema = deliveryListItemSchema.extend({
+  payload: z.record(z.string(), z.unknown()).nullable().optional(),
+  provider_response: z.record(z.string(), z.unknown()).nullable().optional(),
+})

package/src/modules/push_notifications/di.ts

@@ -0,0 +1,20 @@
+import { asValue } from 'awilix'
+import type { AppContainer } from '@open-mercato/shared/lib/di/container'
+import { PushNotificationDelivery } from './data/entities'
+import { ensurePushStubAdapterRegistered } from './lib/push-stub-adapter'
+import { pushNotificationService } from './lib/send-custom-push'
+
+export function register(container: AppContainer) {
+  // Test-only: register the network-free `push_stub` channel adapter when
+  // `OM_ENABLE_PUSH_STUB_ADAPTER` is set (no-op in production). Lets the integration harness drive
+  // the strategy → delivery-row → worker → sendMessage chain without a real provider. Mirrors the
+  // communication_channels test-seed adapter registration. See lib/push-stub-adapter.ts.
+  ensurePushStubAdapterRegistered()
+
+  container.register({
+    PushNotificationDelivery: asValue(PushNotificationDelivery),
+    // Stateless service backing the admin custom-send push (decoupled via DI). The caller passes
+    // its own scoped `resolve` in the call args.
+    pushNotificationService: asValue(pushNotificationService),
+  })
+}

package/src/modules/push_notifications/events.ts

@@ -0,0 +1,21 @@
+import { createModuleEvents } from '@open-mercato/shared/modules/events'
+
+const events = [
+  { id: 'push_notifications.delivery.sent', label: 'Push Delivery Sent', entity: 'delivery', category: 'lifecycle' },
+  {
+    id: 'push_notifications.delivery.failed',
+    label: 'Push Delivery Failed',
+    entity: 'delivery',
+    category: 'lifecycle',
+    // Fires on every failed send attempt for a delivery, not only the terminal one. A retryable
+    // failure that will be re-attempted carries `willRetry: true`; the final give-up (and terminal
+    // errors like channel_unavailable / no_adapter) omit it. Subscribers that count "deliveries that
+    // ultimately failed" MUST filter to `willRetry !== true` to avoid double-counting retries.
+    description: 'A push delivery attempt failed. Carries willRetry:true when another attempt is scheduled.',
+  },
+] as const
+
+export const eventsConfig = createModuleEvents({ moduleId: 'push_notifications', events })
+export const emitPushNotificationsEvent = eventsConfig.emit
+export type PushNotificationsEventId = typeof events[number]['id']
+export default eventsConfig

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

@@ -0,0 +1,79 @@
+{
+  "push_notifications.deliveries.columns.attempts": "Versuche",
+  "push_notifications.deliveries.columns.created": "Erstellt",
+  "push_notifications.deliveries.columns.provider": "Anbieter",
+  "push_notifications.deliveries.columns.sent": "Gesendet",
+  "push_notifications.deliveries.columns.status": "Status",
+  "push_notifications.deliveries.columns.type": "Typ",
+  "push_notifications.deliveries.columns.user": "Benutzer",
+  "push_notifications.deliveries.detail.device": "Gerät",
+  "push_notifications.deliveries.detail.lastError": "Letzter Fehler",
+  "push_notifications.deliveries.detail.loading": "Zustellung wird geladen…",
+  "push_notifications.deliveries.detail.nextRetry": "Nächster Versuch",
+  "push_notifications.deliveries.detail.pageTitle": "Push-Zustellung",
+  "push_notifications.deliveries.detail.payload": "Nutzdaten",
+  "push_notifications.deliveries.detail.providerResponse": "Anbieter-Antwort",
+  "push_notifications.deliveries.detail.tokenSnapshot": "Token (letzte 8)",
+  "push_notifications.deliveries.empty": "Noch keine Push-Zustellungen",
+  "push_notifications.deliveries.error.loadFailed": "Push-Zustellungen konnten nicht geladen werden",
+  "push_notifications.deliveries.filters.created": "Erstellt",
+  "push_notifications.deliveries.filters.from": "Von",
+  "push_notifications.deliveries.filters.to": "Bis",
+  "push_notifications.deliveries.noValue": "—",
+  "push_notifications.deliveries.pageTitle": "Push-Zustellungen",
+  "push_notifications.deliveries.status.expired": "Abgelaufen",
+  "push_notifications.deliveries.status.failed": "Fehlgeschlagen",
+  "push_notifications.deliveries.status.pending": "Ausstehend",
+  "push_notifications.deliveries.status.sending": "Wird gesendet",
+  "push_notifications.deliveries.status.sent": "Gesendet",
+  "push_notifications.deliveries.status.skipped": "Übersprungen",
+  "push_notifications.deliveries.title": "Push-Zustellungen",
+  "push_notifications.errors.forbidden": "Zugriff verweigert",
+  "push_notifications.errors.invalid_id": "Ungültige Zustellungs-ID",
+  "push_notifications.errors.invalid_payload": "Ungültige Anfrage",
+  "push_notifications.errors.not_found": "Zustellung nicht gefunden",
+  "push_notifications.errors.send_failed": "Push-Benachrichtigung konnte nicht gesendet werden",
+  "push_notifications.errors.server_error": "Etwas ist schief gelaufen",
+  "push_notifications.errors.unauthorized": "Nicht autorisiert",
+  "push_notifications.send.badge": "Badge-Zähler",
+  "push_notifications.send.body": "Text",
+  "push_notifications.send.channelId": "Android-Kanal-ID",
+  "push_notifications.send.data": "Daten (eigene Schlüssel/Werte)",
+  "push_notifications.send.dataAdd": "Feld hinzufügen",
+  "push_notifications.send.dataEmpty": "Noch keine eigenen Daten.",
+  "push_notifications.send.dataHint": "Wird in der Push-Nutzlast geliefert — deine App liest sie. Bei einem stillen Push ist dies die gesamte Nutzlast.",
+  "push_notifications.send.dataKey": "Schlüssel",
+  "push_notifications.send.dataRemove": "Feld entfernen",
+  "push_notifications.send.dataValue": "Wert",
+  "push_notifications.send.device": "Gerät",
+  "push_notifications.send.deviceAll": "Alle Geräte",
+  "push_notifications.send.deviceHint": "An dieses bestimmte Gerät oder an alle Geräte des Empfängers senden.",
+  "push_notifications.send.deviceNone": "Dieser Empfänger hat keine push-fähigen Geräte",
+  "push_notifications.send.deviceSelectUserFirst": "Zuerst einen Empfänger auswählen",
+  "push_notifications.send.image": "Bild-URL",
+  "push_notifications.send.message": "Nachricht",
+  "push_notifications.send.mode": "Zustellung",
+  "push_notifications.send.modeHint": "Sichtbar zeigt ein Banner; still ist ein reines Daten-Update im Hintergrund.",
+  "push_notifications.send.modeSilent": "Still (Hintergrund)",
+  "push_notifications.send.modeVisible": "Sichtbar",
+  "push_notifications.send.options": "Push-Optionen",
+  "push_notifications.send.optionsHint": "Optionale Anbieter-Anpassung. Ton/Badge/Bild gelten für sichtbare Pushes.",
+  "push_notifications.send.pageTitle": "Push senden",
+  "push_notifications.send.priority": "Priorität",
+  "push_notifications.send.priorityDefault": "Standard",
+  "push_notifications.send.priorityHigh": "Hoch",
+  "push_notifications.send.priorityNormal": "Normal",
+  "push_notifications.send.sound": "Ton",
+  "push_notifications.send.submit": "Push senden",
+  "push_notifications.send.success": "Push zum Versand eingereiht",
+  "push_notifications.send.title": "Titel",
+  "push_notifications.send.userId": "Empfänger",
+  "push_notifications.send.userIdHint": "Nach Name oder E-Mail suchen — die Geräte dieses Benutzers erhalten den Push.",
+  "push_notifications.types.admin_custom_message.body": "Sie haben eine neue Nachricht.",
+  "push_notifications.types.admin_custom_message.label": "Admin-Nachricht",
+  "push_notifications.types.admin_custom_message.title": "Admin-Nachricht",
+  "push_notifications.types.admin_custom_silent.body": "Hintergrund-Update.",
+  "push_notifications.types.admin_custom_silent.label": "Stille Admin-Nachricht",
+  "push_notifications.types.admin_custom_silent.title": "Stille Nachricht",
+  "push_notifications.warnings.no_matching_devices_in_scope": "Kein push-fähiges Gerät dieses Empfängers passte zum ausgewählten Bereich, daher wurde nichts gesendet."
+}

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

@@ -0,0 +1,79 @@
+{
+  "push_notifications.deliveries.columns.attempts": "Attempts",
+  "push_notifications.deliveries.columns.created": "Created",
+  "push_notifications.deliveries.columns.provider": "Provider",
+  "push_notifications.deliveries.columns.sent": "Sent",
+  "push_notifications.deliveries.columns.status": "Status",
+  "push_notifications.deliveries.columns.type": "Type",
+  "push_notifications.deliveries.columns.user": "User",
+  "push_notifications.deliveries.detail.device": "Device",
+  "push_notifications.deliveries.detail.lastError": "Last error",
+  "push_notifications.deliveries.detail.loading": "Loading delivery…",
+  "push_notifications.deliveries.detail.nextRetry": "Next retry",
+  "push_notifications.deliveries.detail.pageTitle": "Push delivery",
+  "push_notifications.deliveries.detail.payload": "Payload",
+  "push_notifications.deliveries.detail.providerResponse": "Provider response",
+  "push_notifications.deliveries.detail.tokenSnapshot": "Token (last 8)",
+  "push_notifications.deliveries.empty": "No push deliveries yet",
+  "push_notifications.deliveries.error.loadFailed": "Failed to load push deliveries",
+  "push_notifications.deliveries.filters.created": "Created",
+  "push_notifications.deliveries.filters.from": "From",
+  "push_notifications.deliveries.filters.to": "To",
+  "push_notifications.deliveries.noValue": "—",
+  "push_notifications.deliveries.pageTitle": "Push Deliveries",
+  "push_notifications.deliveries.status.expired": "Expired",
+  "push_notifications.deliveries.status.failed": "Failed",
+  "push_notifications.deliveries.status.pending": "Pending",
+  "push_notifications.deliveries.status.sending": "Sending",
+  "push_notifications.deliveries.status.sent": "Sent",
+  "push_notifications.deliveries.status.skipped": "Skipped",
+  "push_notifications.deliveries.title": "Push deliveries",
+  "push_notifications.errors.forbidden": "Access denied",
+  "push_notifications.errors.invalid_id": "Invalid delivery id",
+  "push_notifications.errors.invalid_payload": "Invalid request",
+  "push_notifications.errors.not_found": "Delivery not found",
+  "push_notifications.errors.send_failed": "Failed to send push notification",
+  "push_notifications.errors.server_error": "Something went wrong",
+  "push_notifications.errors.unauthorized": "Unauthorized",
+  "push_notifications.send.badge": "Badge count",
+  "push_notifications.send.body": "Body",
+  "push_notifications.send.channelId": "Android channel ID",
+  "push_notifications.send.data": "Data (custom key/values)",
+  "push_notifications.send.dataAdd": "Add field",
+  "push_notifications.send.dataEmpty": "No custom data yet.",
+  "push_notifications.send.dataHint": "Delivered inside the push payload — your app reads these. For a silent push this is the whole payload.",
+  "push_notifications.send.dataKey": "key",
+  "push_notifications.send.dataRemove": "Remove field",
+  "push_notifications.send.dataValue": "value",
+  "push_notifications.send.device": "Device",
+  "push_notifications.send.deviceAll": "All devices",
+  "push_notifications.send.deviceHint": "Send to this specific device, or all of the recipient's devices.",
+  "push_notifications.send.deviceNone": "This recipient has no push-capable devices",
+  "push_notifications.send.deviceSelectUserFirst": "Select a recipient first",
+  "push_notifications.send.image": "Image URL",
+  "push_notifications.send.message": "Message",
+  "push_notifications.send.mode": "Delivery",
+  "push_notifications.send.modeHint": "Visible shows a banner; silent is a data-only background wake-up.",
+  "push_notifications.send.modeSilent": "Silent (background)",
+  "push_notifications.send.modeVisible": "Visible",
+  "push_notifications.send.options": "Push options",
+  "push_notifications.send.optionsHint": "Optional per-provider customization. Sound/badge/image apply to visible pushes.",
+  "push_notifications.send.pageTitle": "Send Push",
+  "push_notifications.send.priority": "Priority",
+  "push_notifications.send.priorityDefault": "Default",
+  "push_notifications.send.priorityHigh": "High",
+  "push_notifications.send.priorityNormal": "Normal",
+  "push_notifications.send.sound": "Sound",
+  "push_notifications.send.submit": "Send push",
+  "push_notifications.send.success": "Push queued for delivery",
+  "push_notifications.send.title": "Title",
+  "push_notifications.send.userId": "Recipient",
+  "push_notifications.send.userIdHint": "Search by name or email — their devices receive this push.",
+  "push_notifications.types.admin_custom_message.body": "You have a new message.",
+  "push_notifications.types.admin_custom_message.label": "Admin message",
+  "push_notifications.types.admin_custom_message.title": "Admin message",
+  "push_notifications.types.admin_custom_silent.body": "Background update.",
+  "push_notifications.types.admin_custom_silent.label": "Admin silent message",
+  "push_notifications.types.admin_custom_silent.title": "Silent message",
+  "push_notifications.warnings.no_matching_devices_in_scope": "No push-capable devices matched this recipient in the selected scope, so nothing was sent."
+}

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

@@ -0,0 +1,79 @@
+{
+  "push_notifications.deliveries.columns.attempts": "Intentos",
+  "push_notifications.deliveries.columns.created": "Creado",
+  "push_notifications.deliveries.columns.provider": "Proveedor",
+  "push_notifications.deliveries.columns.sent": "Enviado",
+  "push_notifications.deliveries.columns.status": "Estado",
+  "push_notifications.deliveries.columns.type": "Tipo",
+  "push_notifications.deliveries.columns.user": "Usuario",
+  "push_notifications.deliveries.detail.device": "Dispositivo",
+  "push_notifications.deliveries.detail.lastError": "Último error",
+  "push_notifications.deliveries.detail.loading": "Cargando envío…",
+  "push_notifications.deliveries.detail.nextRetry": "Próximo reintento",
+  "push_notifications.deliveries.detail.pageTitle": "Envío push",
+  "push_notifications.deliveries.detail.payload": "Carga útil",
+  "push_notifications.deliveries.detail.providerResponse": "Respuesta del proveedor",
+  "push_notifications.deliveries.detail.tokenSnapshot": "Token (últimos 8)",
+  "push_notifications.deliveries.empty": "Aún no hay envíos push",
+  "push_notifications.deliveries.error.loadFailed": "No se pudieron cargar los envíos push",
+  "push_notifications.deliveries.filters.created": "Creado",
+  "push_notifications.deliveries.filters.from": "Desde",
+  "push_notifications.deliveries.filters.to": "Hasta",
+  "push_notifications.deliveries.noValue": "—",
+  "push_notifications.deliveries.pageTitle": "Envíos push",
+  "push_notifications.deliveries.status.expired": "Expirado",
+  "push_notifications.deliveries.status.failed": "Fallido",
+  "push_notifications.deliveries.status.pending": "Pendiente",
+  "push_notifications.deliveries.status.sending": "Enviando",
+  "push_notifications.deliveries.status.sent": "Enviado",
+  "push_notifications.deliveries.status.skipped": "Omitido",
+  "push_notifications.deliveries.title": "Envíos push",
+  "push_notifications.errors.forbidden": "Acceso denegado",
+  "push_notifications.errors.invalid_id": "ID de envío no válido",
+  "push_notifications.errors.invalid_payload": "Solicitud no válida",
+  "push_notifications.errors.not_found": "Envío no encontrado",
+  "push_notifications.errors.send_failed": "No se pudo enviar la notificación push",
+  "push_notifications.errors.server_error": "Algo salió mal",
+  "push_notifications.errors.unauthorized": "No autorizado",
+  "push_notifications.send.badge": "Contador de insignia",
+  "push_notifications.send.body": "Cuerpo",
+  "push_notifications.send.channelId": "ID de canal Android",
+  "push_notifications.send.data": "Datos (clave/valor personalizados)",
+  "push_notifications.send.dataAdd": "Añadir campo",
+  "push_notifications.send.dataEmpty": "Aún no hay datos personalizados.",
+  "push_notifications.send.dataHint": "Se entrega dentro del payload del push — tu app los lee. Para un push silencioso es todo el payload.",
+  "push_notifications.send.dataKey": "clave",
+  "push_notifications.send.dataRemove": "Eliminar campo",
+  "push_notifications.send.dataValue": "valor",
+  "push_notifications.send.device": "Dispositivo",
+  "push_notifications.send.deviceAll": "Todos los dispositivos",
+  "push_notifications.send.deviceHint": "Enviar a este dispositivo específico o a todos los dispositivos del destinatario.",
+  "push_notifications.send.deviceNone": "Este destinatario no tiene dispositivos compatibles con push",
+  "push_notifications.send.deviceSelectUserFirst": "Selecciona primero un destinatario",
+  "push_notifications.send.image": "URL de imagen",
+  "push_notifications.send.message": "Mensaje",
+  "push_notifications.send.mode": "Entrega",
+  "push_notifications.send.modeHint": "Visible muestra un banner; silencioso es una actualización de datos en segundo plano.",
+  "push_notifications.send.modeSilent": "Silencioso (segundo plano)",
+  "push_notifications.send.modeVisible": "Visible",
+  "push_notifications.send.options": "Opciones de push",
+  "push_notifications.send.optionsHint": "Personalización opcional por proveedor. Sonido/insignia/imagen aplican a pushes visibles.",
+  "push_notifications.send.pageTitle": "Enviar push",
+  "push_notifications.send.priority": "Prioridad",
+  "push_notifications.send.priorityDefault": "Predeterminado",
+  "push_notifications.send.priorityHigh": "Alta",
+  "push_notifications.send.priorityNormal": "Normal",
+  "push_notifications.send.sound": "Sonido",
+  "push_notifications.send.submit": "Enviar push",
+  "push_notifications.send.success": "Push en cola para envío",
+  "push_notifications.send.title": "Título",
+  "push_notifications.send.userId": "Destinatario",
+  "push_notifications.send.userIdHint": "Busca por nombre o correo — sus dispositivos reciben este push.",
+  "push_notifications.types.admin_custom_message.body": "Tienes un mensaje nuevo.",
+  "push_notifications.types.admin_custom_message.label": "Mensaje de administrador",
+  "push_notifications.types.admin_custom_message.title": "Mensaje de administrador",
+  "push_notifications.types.admin_custom_silent.body": "Actualización en segundo plano.",
+  "push_notifications.types.admin_custom_silent.label": "Mensaje silencioso de administrador",
+  "push_notifications.types.admin_custom_silent.title": "Mensaje silencioso",
+  "push_notifications.warnings.no_matching_devices_in_scope": "Ningún dispositivo con capacidad de push de este destinatario coincidió con el ámbito seleccionado, por lo que no se envió nada."
+}

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

@@ -0,0 +1,79 @@
+{
+  "push_notifications.deliveries.columns.attempts": "시도 횟수",
+  "push_notifications.deliveries.columns.created": "생성됨",
+  "push_notifications.deliveries.columns.provider": "제공업체",
+  "push_notifications.deliveries.columns.sent": "전송됨",
+  "push_notifications.deliveries.columns.status": "상태",
+  "push_notifications.deliveries.columns.type": "유형",
+  "push_notifications.deliveries.columns.user": "사용자",
+  "push_notifications.deliveries.detail.device": "기기",
+  "push_notifications.deliveries.detail.lastError": "마지막 오류",
+  "push_notifications.deliveries.detail.loading": "전송 내역을 불러오는 중…",
+  "push_notifications.deliveries.detail.nextRetry": "다음 재시도",
+  "push_notifications.deliveries.detail.pageTitle": "푸시 전송",
+  "push_notifications.deliveries.detail.payload": "페이로드",
+  "push_notifications.deliveries.detail.providerResponse": "제공자 응답",
+  "push_notifications.deliveries.detail.tokenSnapshot": "토큰 (마지막 8자리)",
+  "push_notifications.deliveries.empty": "아직 푸시 전송 내역이 없습니다",
+  "push_notifications.deliveries.error.loadFailed": "푸시 전송 내역을 불러오지 못했습니다",
+  "push_notifications.deliveries.filters.created": "생성됨",
+  "push_notifications.deliveries.filters.from": "시작일",
+  "push_notifications.deliveries.filters.to": "종료일",
+  "push_notifications.deliveries.noValue": "—",
+  "push_notifications.deliveries.pageTitle": "푸시 전송 내역",
+  "push_notifications.deliveries.status.expired": "만료됨",
+  "push_notifications.deliveries.status.failed": "실패",
+  "push_notifications.deliveries.status.pending": "대기 중",
+  "push_notifications.deliveries.status.sending": "전송 중",
+  "push_notifications.deliveries.status.sent": "전송됨",
+  "push_notifications.deliveries.status.skipped": "건너뜀",
+  "push_notifications.deliveries.title": "푸시 전송 내역",
+  "push_notifications.errors.forbidden": "접근이 거부되었습니다",
+  "push_notifications.errors.invalid_id": "잘못된 전송 ID입니다",
+  "push_notifications.errors.invalid_payload": "잘못된 요청입니다",
+  "push_notifications.errors.not_found": "전송 내역을 찾을 수 없습니다",
+  "push_notifications.errors.send_failed": "푸시 알림을 전송하지 못했습니다",
+  "push_notifications.errors.server_error": "문제가 발생했습니다",
+  "push_notifications.errors.unauthorized": "권한이 없습니다",
+  "push_notifications.send.badge": "배지 숫자",
+  "push_notifications.send.body": "본문",
+  "push_notifications.send.channelId": "Android 채널 ID",
+  "push_notifications.send.data": "데이터 (사용자 지정 키/값)",
+  "push_notifications.send.dataAdd": "필드 추가",
+  "push_notifications.send.dataEmpty": "아직 사용자 지정 데이터가 없습니다.",
+  "push_notifications.send.dataHint": "푸시 페이로드에 담겨 전달되며 앱에서 이 값을 읽습니다. 무음 푸시에서는 이 데이터가 페이로드 전체가 됩니다.",
+  "push_notifications.send.dataKey": "키",
+  "push_notifications.send.dataRemove": "필드 삭제",
+  "push_notifications.send.dataValue": "값",
+  "push_notifications.send.device": "기기",
+  "push_notifications.send.deviceAll": "모든 기기",
+  "push_notifications.send.deviceHint": "이 특정 기기로 보내거나, 수신자의 모든 기기로 보냅니다.",
+  "push_notifications.send.deviceNone": "이 수신자에게는 푸시를 받을 수 있는 기기가 없습니다",
+  "push_notifications.send.deviceSelectUserFirst": "먼저 수신자를 선택하세요",
+  "push_notifications.send.image": "이미지 URL",
+  "push_notifications.send.message": "메시지",
+  "push_notifications.send.mode": "전송 방식",
+  "push_notifications.send.modeHint": "표시 푸시는 배너를 보여 주고, 무음 푸시는 데이터만 전달해 백그라운드에서 앱을 깨웁니다.",
+  "push_notifications.send.modeSilent": "무음 (백그라운드)",
+  "push_notifications.send.modeVisible": "표시",
+  "push_notifications.send.options": "푸시 옵션",
+  "push_notifications.send.optionsHint": "제공자별 선택 설정입니다. 소리/배지/이미지는 표시 푸시에만 적용됩니다.",
+  "push_notifications.send.pageTitle": "푸시 보내기",
+  "push_notifications.send.priority": "우선순위",
+  "push_notifications.send.priorityDefault": "기본값",
+  "push_notifications.send.priorityHigh": "높음",
+  "push_notifications.send.priorityNormal": "보통",
+  "push_notifications.send.sound": "소리",
+  "push_notifications.send.submit": "푸시 보내기",
+  "push_notifications.send.success": "푸시가 전송 대기열에 추가되었습니다",
+  "push_notifications.send.title": "제목",
+  "push_notifications.send.userId": "수신자",
+  "push_notifications.send.userIdHint": "이름 또는 이메일로 검색하세요 — 해당 사용자의 기기로 이 푸시가 전송됩니다.",
+  "push_notifications.types.admin_custom_message.body": "새 메시지가 도착했습니다.",
+  "push_notifications.types.admin_custom_message.label": "관리자 메시지",
+  "push_notifications.types.admin_custom_message.title": "관리자 메시지",
+  "push_notifications.types.admin_custom_silent.body": "백그라운드 업데이트입니다.",
+  "push_notifications.types.admin_custom_silent.label": "관리자 무음 메시지",
+  "push_notifications.types.admin_custom_silent.title": "무음 메시지",
+  "push_notifications.warnings.no_matching_devices_in_scope": "선택한 범위에서 이 수신자와 일치하는 푸시 가능 기기가 없어 아무것도 전송되지 않았습니다."
+}