@plyaz/types 1.13.17 → 1.14.0

package/dist/notifications/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Notifications Module
+ *
+ * Type definitions, enums, and validation schemas for @plyaz/notifications package
+ *
+ * @module notifications
+ */
+export * from './enums';
+export * from './schemas';
+export * from './webhooks.schemas';
+export type * from './types';

package/dist/notifications/index.js

@@ -139,7 +139,139 @@ var QueuePrioritySchema = z.enum(["high", "normal", "low"]);
 var CorrelationIdSchema = z.string().uuid("Correlation ID must be a valid UUID v4").describe("UUID v4 correlation ID");
 var TemplateDataSchema = z.record(z.string(), z.unknown()).optional();
 var DeviceTokenSchema = z.string().min(1, "Device token is required").max(MAX_DEVICE_TOKEN_LENGTH, "Device token must be 512 characters or less");
+var InfobipEmailStatusSchema = z.object({
+  groupId: z.number().optional(),
+  groupName: z.string().optional(),
+  id: z.number().optional(),
+  name: z.string().optional(),
+  description: z.string().optional(),
+  action: z.string().optional()
+});
+var InfobipErrorInfoSchema = z.object({
+  groupId: z.number().optional(),
+  groupName: z.string().optional(),
+  id: z.number().optional(),
+  name: z.string().optional(),
+  description: z.string().optional(),
+  permanent: z.boolean().optional()
+});
+var InfobipPriceInfoSchema = z.object({
+  pricePerMessage: z.number().optional(),
+  currency: z.string().optional()
+});
+var InfobipDeliveryResultSchema = z.object({
+  messageId: z.string().optional(),
+  to: z.string().optional(),
+  bulkId: z.string().optional(),
+  sentAt: z.string().optional(),
+  doneAt: z.string().optional(),
+  status: InfobipEmailStatusSchema.optional(),
+  error: InfobipErrorInfoSchema.optional(),
+  attemptCount: z.number().optional(),
+  timeToFirstAttempt: z.number().optional(),
+  sendingIp: z.string().optional(),
+  price: InfobipPriceInfoSchema.optional(),
+  smsCount: z.number().optional(),
+  browserLink: z.string().optional(),
+  applicationId: z.string().optional(),
+  entityId: z.string().optional(),
+  campaignReferenceId: z.string().optional(),
+  callbackData: z.string().optional()
+}).loose();
+var InfobipDeliveryWebhookSchema = z.object({
+  results: z.array(InfobipDeliveryResultSchema)
+});
+var InfobipGeoLocationSchema = z.object({
+  countryName: z.string().optional(),
+  countryCode: z.string().optional(),
+  regionName: z.string().optional(),
+  city: z.string().optional(),
+  latitude: z.number().optional(),
+  longitude: z.number().optional()
+}).loose();
+var InfobipRecipientInfoSchema = z.object({
+  messageId: z.number().optional(),
+  to: z.string().optional(),
+  requestId: z.string().optional(),
+  sentDateTime: z.number().optional()
+}).loose();
+var InfobipTrackingEventSchema = z.object({
+  messageId: z.number().optional(),
+  bulkId: z.string().optional(),
+  recipient: z.string().optional(),
+  sender: z.string().optional(),
+  domain: z.string().optional(),
+  notificationType: z.string().optional(),
+  // OPENED, CLICKED, COMPLAINED, LATE_BOUNCE, UNSUBSCRIBED
+  eventId: z.string().optional(),
+  sendDateTime: z.number().optional(),
+  url: z.string().optional(),
+  // For CLICKED events
+  applicationId: z.string().optional(),
+  entityId: z.string().optional(),
+  campaignReferenceId: z.string().optional(),
+  callbackData: z.string().optional(),
+  geoLocation: InfobipGeoLocationSchema.optional(),
+  recipientInfo: InfobipRecipientInfoSchema.optional()
+}).loose();
+var InfobipTrackingWebhookSchema = z.object({
+  messageId: z.number().optional(),
+  bulkId: z.string().optional(),
+  recipient: z.string().optional(),
+  sender: z.string().optional(),
+  domain: z.string().optional(),
+  notificationType: z.string().optional(),
+  eventId: z.string().optional(),
+  sendDateTime: z.number().optional(),
+  url: z.string().optional(),
+  applicationId: z.string().optional(),
+  entityId: z.string().optional(),
+  campaignReferenceId: z.string().optional(),
+  callbackData: z.string().optional(),
+  geoLocation: InfobipGeoLocationSchema.optional(),
+  recipientInfo: InfobipRecipientInfoSchema.optional()
+}).loose();
+var SendGridEventSchema = z.object({
+  email: z.string().email(),
+  timestamp: z.number(),
+  event: z.enum([
+    "processed",
+    "dropped",
+    "delivered",
+    "deferred",
+    "bounce",
+    "open",
+    "click",
+    "spam_report",
+    "unsubscribe",
+    "group_unsubscribe",
+    "group_resubscribe"
+  ]),
+  sg_event_id: z.string(),
+  sg_message_id: z.string(),
+  // Custom args (our notification metadata)
+  notification_id: z.string().optional(),
+  recipient_id: z.string().optional(),
+  category: z.string().optional(),
+  // Event-specific fields
+  url: z.string().optional(),
+  // For click events
+  reason: z.string().optional(),
+  // For bounce/drop events
+  status: z.string().optional(),
+  // For drop/bounce events
+  response: z.string().optional(),
+  // For bounce events
+  useragent: z.string().optional(),
+  // For open/click events
+  ip: z.string().optional(),
+  // For open/click events
+  // Unsubscribe-specific
+  asm_group_id: z.number().optional()
+  // Unsubscribe group ID
+}).loose();
+var SendGridWebhookSchema = z.array(SendGridEventSchema);
 
-export { CorrelationIdSchema, DeviceTokenSchema, EmailSchema, FILE_EXTENSIONS, LocaleSchema, MIME_TYPES, NOTIFICATION_CATEGORIES, NOTIFICATION_CHANNELS, NOTIFICATION_PROVIDERS, NotificationCategorySchema, PhoneSchema, QueuePrioritySchema, SIGNATURE_METHOD, TemplateDataSchema, TemplateIdSchema, UserIdSchema, WEBHOOK_ENCRYPTION_METHOD, WEBHOOK_EVENT_TYPE };
+export { CorrelationIdSchema, DeviceTokenSchema, EmailSchema, FILE_EXTENSIONS, InfobipDeliveryResultSchema, InfobipDeliveryWebhookSchema, InfobipEmailStatusSchema, InfobipErrorInfoSchema, InfobipGeoLocationSchema, InfobipPriceInfoSchema, InfobipRecipientInfoSchema, InfobipTrackingEventSchema, InfobipTrackingWebhookSchema, LocaleSchema, MIME_TYPES, NOTIFICATION_CATEGORIES, NOTIFICATION_CHANNELS, NOTIFICATION_PROVIDERS, NotificationCategorySchema, PhoneSchema, QueuePrioritySchema, SIGNATURE_METHOD, SendGridEventSchema, SendGridWebhookSchema, TemplateDataSchema, TemplateIdSchema, UserIdSchema, WEBHOOK_ENCRYPTION_METHOD, WEBHOOK_EVENT_TYPE };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/enums.ts","../../src/notifications/schemas.ts"],"names":["SIGNATURE_METHOD","WEBHOOK_EVENT_TYPE","WEBHOOK_ENCRYPTION_METHOD"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Notification Constants and Enums\n *\n * Type-level constants and enum values for the notifications system.\n *\n * @module notifications/enums\n */\n\n/**\n * Notification Providers\n * Standard provider names to ensure consistency across the package\n */\nexport const NOTIFICATION_PROVIDERS = {\n  /** Infobip omnichannel provider (Email, SMS, WhatsApp) - PRIMARY */\n  INFOBIP: 'Infobip',\n\n  /** SendGrid email provider - FALLBACK */\n  SENDGRID: 'SendGrid',\n\n  /** Mock email provider for testing */\n  MOCK_EMAIL: 'MockEmail',\n\n  /** Mock SMS provider for testing */\n  MOCK_SMS: 'MockSMS',\n\n  /** Mock push provider for testing */\n  MOCK_PUSH: 'MockPush',\n} as const;\n\n/**\n * Notification Channels\n * Available notification delivery channels\n */\nexport const NOTIFICATION_CHANNELS = {\n  EMAIL: 'email',\n  SMS: 'sms',\n  PUSH: 'push',\n} as const;\n\n/**\n * Notification Categories (FR-4.3)\n * Determines opt-out behavior for compliance\n */\nexport const NOTIFICATION_CATEGORIES = {\n  /** Cannot be opted out - compliance requirement (password resets, order confirmations) */\n  TRANSACTIONAL: 'transactional',\n\n  /** User can opt-out (newsletters, promotions) */\n  MARKETING: 'marketing',\n\n  /** User can opt-out (likes, comments, follows) */\n  SOCIAL: 'social',\n\n  /** System alerts and notifications (security alerts, system status) */\n  SYSTEM: 'system',\n\n  /** Promotional offers and campaigns */\n  PROMOTIONAL: 'promotional',\n} as const;\n\n/**\n * Signature verification method for webhooks\n */\nexport enum SIGNATURE_METHOD {\n  HmacSha256 = 'hmac-sha256',\n  HmacSha1 = 'hmac-sha1',\n  HmacSha512 = 'hmac-sha512',\n  Custom = 'custom',\n}\n\n/**\n * Webhook event types mapped to internal notification events\n */\nexport enum WEBHOOK_EVENT_TYPE {\n  // Delivery events\n  Delivered = 'delivered',\n  Bounced = 'bounced',\n  Deferred = 'deferred',\n  Dropped = 'dropped',\n\n  // Engagement events\n  Opened = 'opened',\n  Clicked = 'clicked',\n\n  // Spam/unsubscribe events\n  SpamReport = 'spam_report',\n  Unsubscribed = 'unsubscribed',\n\n  // SMS-specific\n  SmsDelivered = 'sms_delivered',\n  SmsFailed = 'sms_failed',\n\n  // Push-specific\n  PushDelivered = 'push_delivered',\n  PushFailed = 'push_failed',\n\n  // Generic\n  Unknown = 'unknown',\n}\n\n/**\n * Webhook encryption method for PII-safe IDs\n */\nexport enum WEBHOOK_ENCRYPTION_METHOD {\n  /** HMAC-SHA256 hashing (recommended for IDs) */\n  HmacSha256 = 'hmac-sha256',\n  /** HMAC-SHA512 hashing (stronger) */\n  HmacSha512 = 'hmac-sha512',\n  /** No encryption (not recommended) */\n  None = 'none',\n}\n\n/**\n * Common MIME types for attachments\n */\nexport const MIME_TYPES = {\n  // Documents\n  PDF: 'application/pdf',\n  DOC: 'application/msword',\n  DOCX: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  XLS: 'application/vnd.ms-excel',\n  XLSX: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  PPT: 'application/vnd.ms-powerpoint',\n  PPTX: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n  TXT: 'text/plain',\n  CSV: 'text/csv',\n\n  // Images\n  PNG: 'image/png',\n  JPG: 'image/jpeg',\n  JPEG: 'image/jpeg',\n  GIF: 'image/gif',\n  SVG: 'image/svg+xml',\n  WEBP: 'image/webp',\n\n  // Archives\n  ZIP: 'application/zip',\n  RAR: 'application/x-rar-compressed',\n  TAR: 'application/x-tar',\n  GZIP: 'application/gzip',\n\n  // Other\n  JSON: 'application/json',\n  XML: 'application/xml',\n} as const;\n\n/**\n * Common file extensions for attachments\n */\nexport const FILE_EXTENSIONS = {\n  // Documents\n  PDF: '.pdf',\n  DOC: '.doc',\n  DOCX: '.docx',\n  XLS: '.xls',\n  XLSX: '.xlsx',\n  PPT: '.ppt',\n  PPTX: '.pptx',\n  TXT: '.txt',\n  CSV: '.csv',\n\n  // Images\n  PNG: '.png',\n  JPG: '.jpg',\n  JPEG: '.jpeg',\n  GIF: '.gif',\n  SVG: '.svg',\n  WEBP: '.webp',\n\n  // Archives\n  ZIP: '.zip',\n  RAR: '.rar',\n  TAR: '.tar',\n  GZ: '.gz',\n  GZIP: '.gzip',\n\n  // Other\n  JSON: '.json',\n  XML: '.xml',\n} as const;\n","/**\n * Notification Validation Schemas\n *\n * Zod schemas for validating notification inputs\n * Ensures type safety and prevents invalid data from entering the system\n *\n * @module notifications/schemas\n */\n\nimport { z } from 'zod';\nimport { NOTIFICATION_CATEGORIES } from './enums';\n\n// Validation length constants\nconst MAX_EMAIL_LENGTH = 255;\nconst MAX_USER_ID_LENGTH = 255;\nconst MAX_TEMPLATE_ID_LENGTH = 255;\nconst MAX_DEVICE_TOKEN_LENGTH = 512;\n\n/**\n * Email address validation\n * - Must be valid email format\n * - Max 255 characters\n * - Automatically lowercased and trimmed\n */\nexport const EmailSchema = z\n  .string()\n  .email('Invalid email address format')\n  .max(MAX_EMAIL_LENGTH, 'Email address must be 255 characters or less')\n  .transform(val => val.trim().toLowerCase());\n\n/**\n * Phone number validation (E.164 format)\n * - Must start with optional + followed by country code\n * - 1-15 digits total (E.164 standard)\n * - Examples: +14155552671, +442071838750, +8613800000000\n */\nexport const PhoneSchema = z\n  .string()\n  .regex(/^\\+?[1-9]\\d{1,14}$/, 'Invalid phone number format (E.164 expected)')\n  .describe('Phone number in E.164 format');\n\n/**\n * User ID validation\n * - Required, non-empty string\n * - Max 255 characters\n */\nexport const UserIdSchema = z\n  .string()\n  .min(1, 'User ID is required')\n  .max(MAX_USER_ID_LENGTH, 'User ID must be 255 characters or less');\n\n/**\n * Template ID validation\n * - Only lowercase letters, numbers, hyphens, and slashes\n * - Used for file path construction, must be safe\n * - Examples: welcome, password-reset, order/confirmation\n */\nexport const TemplateIdSchema = z\n  .string()\n  .min(1, 'Template ID is required')\n  .regex(\n    /^[a-z0-9-/]+$/,\n    'Template ID must contain only lowercase letters, numbers, hyphens, and slashes'\n  )\n  .max(MAX_TEMPLATE_ID_LENGTH, 'Template ID must be 255 characters or less');\n\n/**\n * Locale validation\n * - ISO 639-1 language code (2 lowercase letters)\n * - Optional ISO 3166-1 country code (2 uppercase letters)\n * - Examples: en, en-US, es, es-MX, fr-FR\n */\nexport const LocaleSchema = z\n  .string()\n  .regex(/^[a-z]{2}(-[A-Z]{2})?$/, 'Locale must be in format: en, en-US, es, es-MX')\n  .describe('Locale in ISO 639-1 format');\n\n/**\n * Notification category validation (FR-4.3)\n * - transactional: Cannot be opted out (compliance requirement)\n * - marketing: User can opt-out\n * - social: User can opt-out\n */\nexport const NotificationCategorySchema = z\n  .enum([\n    NOTIFICATION_CATEGORIES.TRANSACTIONAL,\n    NOTIFICATION_CATEGORIES.MARKETING,\n    NOTIFICATION_CATEGORIES.SOCIAL,\n    NOTIFICATION_CATEGORIES.SYSTEM,\n    NOTIFICATION_CATEGORIES.PROMOTIONAL,\n  ] as const)\n  .default(NOTIFICATION_CATEGORIES.TRANSACTIONAL)\n  .describe('Notification category for compliance and user preferences');\n\n/**\n * Queue priority validation\n */\nexport const QueuePrioritySchema = z.enum(['high', 'normal', 'low']);\n\n/**\n * Correlation ID validation\n * - UUID v4 format\n * - Used for tracing across systems\n */\nexport const CorrelationIdSchema = z\n  .string()\n  .uuid('Correlation ID must be a valid UUID v4')\n  .describe('UUID v4 correlation ID');\n\n/**\n * Template data validation\n * - Must be a valid object\n * - Can contain strings, numbers, booleans, or nested objects\n * - Arrays are allowed\n */\nexport const TemplateDataSchema = z.record(z.string(), z.unknown()).optional();\n\n/**\n * Device token validation (for push notifications)\n * - Non-empty string\n * - Max 512 characters (FCM tokens can be quite long)\n */\nexport const DeviceTokenSchema = z\n  .string()\n  .min(1, 'Device token is required')\n  .max(MAX_DEVICE_TOKEN_LENGTH, 'Device token must be 512 characters or less');\n"]}
+{"version":3,"sources":["../../src/notifications/enums.ts","../../src/notifications/schemas.ts","../../src/notifications/webhooks.schemas.ts"],"names":["SIGNATURE_METHOD","WEBHOOK_EVENT_TYPE","WEBHOOK_ENCRYPTION_METHOD","z"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Notification Constants and Enums\n *\n * Type-level constants and enum values for the notifications system.\n *\n * @module notifications/enums\n */\n\n/**\n * Notification Providers\n * Standard provider names to ensure consistency across the package\n */\nexport const NOTIFICATION_PROVIDERS = {\n  /** Infobip omnichannel provider (Email, SMS, WhatsApp) - PRIMARY */\n  INFOBIP: 'Infobip',\n\n  /** SendGrid email provider - FALLBACK */\n  SENDGRID: 'SendGrid',\n\n  /** Mock email provider for testing */\n  MOCK_EMAIL: 'MockEmail',\n\n  /** Mock SMS provider for testing */\n  MOCK_SMS: 'MockSMS',\n\n  /** Mock push provider for testing */\n  MOCK_PUSH: 'MockPush',\n} as const;\n\n/**\n * Notification Channels\n * Available notification delivery channels\n */\nexport const NOTIFICATION_CHANNELS = {\n  EMAIL: 'email',\n  SMS: 'sms',\n  PUSH: 'push',\n} as const;\n\n/**\n * Notification Categories (FR-4.3)\n * Determines opt-out behavior for compliance\n */\nexport const NOTIFICATION_CATEGORIES = {\n  /** Cannot be opted out - compliance requirement (password resets, order confirmations) */\n  TRANSACTIONAL: 'transactional',\n\n  /** User can opt-out (newsletters, promotions) */\n  MARKETING: 'marketing',\n\n  /** User can opt-out (likes, comments, follows) */\n  SOCIAL: 'social',\n\n  /** System alerts and notifications (security alerts, system status) */\n  SYSTEM: 'system',\n\n  /** Promotional offers and campaigns */\n  PROMOTIONAL: 'promotional',\n} as const;\n\n/**\n * Signature verification method for webhooks\n */\nexport enum SIGNATURE_METHOD {\n  HmacSha256 = 'hmac-sha256',\n  HmacSha1 = 'hmac-sha1',\n  HmacSha512 = 'hmac-sha512',\n  Custom = 'custom',\n}\n\n/**\n * Webhook event types mapped to internal notification events\n */\nexport enum WEBHOOK_EVENT_TYPE {\n  // Delivery events\n  Delivered = 'delivered',\n  Bounced = 'bounced',\n  Deferred = 'deferred',\n  Dropped = 'dropped',\n\n  // Engagement events\n  Opened = 'opened',\n  Clicked = 'clicked',\n\n  // Spam/unsubscribe events\n  SpamReport = 'spam_report',\n  Unsubscribed = 'unsubscribed',\n\n  // SMS-specific\n  SmsDelivered = 'sms_delivered',\n  SmsFailed = 'sms_failed',\n\n  // Push-specific\n  PushDelivered = 'push_delivered',\n  PushFailed = 'push_failed',\n\n  // Generic\n  Unknown = 'unknown',\n}\n\n/**\n * Webhook encryption method for PII-safe IDs\n */\nexport enum WEBHOOK_ENCRYPTION_METHOD {\n  /** HMAC-SHA256 hashing (recommended for IDs) */\n  HmacSha256 = 'hmac-sha256',\n  /** HMAC-SHA512 hashing (stronger) */\n  HmacSha512 = 'hmac-sha512',\n  /** No encryption (not recommended) */\n  None = 'none',\n}\n\n/**\n * Common MIME types for attachments\n */\nexport const MIME_TYPES = {\n  // Documents\n  PDF: 'application/pdf',\n  DOC: 'application/msword',\n  DOCX: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  XLS: 'application/vnd.ms-excel',\n  XLSX: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  PPT: 'application/vnd.ms-powerpoint',\n  PPTX: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n  TXT: 'text/plain',\n  CSV: 'text/csv',\n\n  // Images\n  PNG: 'image/png',\n  JPG: 'image/jpeg',\n  JPEG: 'image/jpeg',\n  GIF: 'image/gif',\n  SVG: 'image/svg+xml',\n  WEBP: 'image/webp',\n\n  // Archives\n  ZIP: 'application/zip',\n  RAR: 'application/x-rar-compressed',\n  TAR: 'application/x-tar',\n  GZIP: 'application/gzip',\n\n  // Other\n  JSON: 'application/json',\n  XML: 'application/xml',\n} as const;\n\n/**\n * Common file extensions for attachments\n */\nexport const FILE_EXTENSIONS = {\n  // Documents\n  PDF: '.pdf',\n  DOC: '.doc',\n  DOCX: '.docx',\n  XLS: '.xls',\n  XLSX: '.xlsx',\n  PPT: '.ppt',\n  PPTX: '.pptx',\n  TXT: '.txt',\n  CSV: '.csv',\n\n  // Images\n  PNG: '.png',\n  JPG: '.jpg',\n  JPEG: '.jpeg',\n  GIF: '.gif',\n  SVG: '.svg',\n  WEBP: '.webp',\n\n  // Archives\n  ZIP: '.zip',\n  RAR: '.rar',\n  TAR: '.tar',\n  GZ: '.gz',\n  GZIP: '.gzip',\n\n  // Other\n  JSON: '.json',\n  XML: '.xml',\n} as const;\n","/**\n * Notification Validation Schemas\n *\n * Zod schemas for validating notification inputs\n * Ensures type safety and prevents invalid data from entering the system\n *\n * @module notifications/schemas\n */\n\nimport { z } from 'zod';\nimport { NOTIFICATION_CATEGORIES } from './enums';\n\n// Validation length constants\nconst MAX_EMAIL_LENGTH = 255;\nconst MAX_USER_ID_LENGTH = 255;\nconst MAX_TEMPLATE_ID_LENGTH = 255;\nconst MAX_DEVICE_TOKEN_LENGTH = 512;\n\n/**\n * Email address validation\n * - Must be valid email format\n * - Max 255 characters\n * - Automatically lowercased and trimmed\n */\nexport const EmailSchema = z\n  .string()\n  .email('Invalid email address format')\n  .max(MAX_EMAIL_LENGTH, 'Email address must be 255 characters or less')\n  .transform(val => val.trim().toLowerCase());\n\n/**\n * Phone number validation (E.164 format)\n * - Must start with optional + followed by country code\n * - 1-15 digits total (E.164 standard)\n * - Examples: +14155552671, +442071838750, +8613800000000\n */\nexport const PhoneSchema = z\n  .string()\n  .regex(/^\\+?[1-9]\\d{1,14}$/, 'Invalid phone number format (E.164 expected)')\n  .describe('Phone number in E.164 format');\n\n/**\n * User ID validation\n * - Required, non-empty string\n * - Max 255 characters\n */\nexport const UserIdSchema = z\n  .string()\n  .min(1, 'User ID is required')\n  .max(MAX_USER_ID_LENGTH, 'User ID must be 255 characters or less');\n\n/**\n * Template ID validation\n * - Only lowercase letters, numbers, hyphens, and slashes\n * - Used for file path construction, must be safe\n * - Examples: welcome, password-reset, order/confirmation\n */\nexport const TemplateIdSchema = z\n  .string()\n  .min(1, 'Template ID is required')\n  .regex(\n    /^[a-z0-9-/]+$/,\n    'Template ID must contain only lowercase letters, numbers, hyphens, and slashes'\n  )\n  .max(MAX_TEMPLATE_ID_LENGTH, 'Template ID must be 255 characters or less');\n\n/**\n * Locale validation\n * - ISO 639-1 language code (2 lowercase letters)\n * - Optional ISO 3166-1 country code (2 uppercase letters)\n * - Examples: en, en-US, es, es-MX, fr-FR\n */\nexport const LocaleSchema = z\n  .string()\n  .regex(/^[a-z]{2}(-[A-Z]{2})?$/, 'Locale must be in format: en, en-US, es, es-MX')\n  .describe('Locale in ISO 639-1 format');\n\n/**\n * Notification category validation (FR-4.3)\n * - transactional: Cannot be opted out (compliance requirement)\n * - marketing: User can opt-out\n * - social: User can opt-out\n */\nexport const NotificationCategorySchema = z\n  .enum([\n    NOTIFICATION_CATEGORIES.TRANSACTIONAL,\n    NOTIFICATION_CATEGORIES.MARKETING,\n    NOTIFICATION_CATEGORIES.SOCIAL,\n    NOTIFICATION_CATEGORIES.SYSTEM,\n    NOTIFICATION_CATEGORIES.PROMOTIONAL,\n  ] as const)\n  .default(NOTIFICATION_CATEGORIES.TRANSACTIONAL)\n  .describe('Notification category for compliance and user preferences');\n\n/**\n * Queue priority validation\n */\nexport const QueuePrioritySchema = z.enum(['high', 'normal', 'low']);\n\n/**\n * Correlation ID validation\n * - UUID v4 format\n * - Used for tracing across systems\n */\nexport const CorrelationIdSchema = z\n  .string()\n  .uuid('Correlation ID must be a valid UUID v4')\n  .describe('UUID v4 correlation ID');\n\n/**\n * Template data validation\n * - Must be a valid object\n * - Can contain strings, numbers, booleans, or nested objects\n * - Arrays are allowed\n */\nexport const TemplateDataSchema = z.record(z.string(), z.unknown()).optional();\n\n/**\n * Device token validation (for push notifications)\n * - Non-empty string\n * - Max 512 characters (FCM tokens can be quite long)\n */\nexport const DeviceTokenSchema = z\n  .string()\n  .min(1, 'Device token is required')\n  .max(MAX_DEVICE_TOKEN_LENGTH, 'Device token must be 512 characters or less');\n","/**\n * Webhook Validation Schemas\n *\n * Zod schemas for validating webhook payloads from notification providers\n * Provider-specific webhook event structures\n *\n * @module notifications/webhooks.schemas\n */\n\nimport { z } from 'zod';\n\n// ============================================================================\n// INFOBIP EMAIL DELIVERY WEBHOOK SCHEMAS\n// ============================================================================\n\n/**\n * Infobip Email Status schema\n */\nexport const InfobipEmailStatusSchema = z.object({\n  groupId: z.number().optional(),\n  groupName: z.string().optional(),\n  id: z.number().optional(),\n  name: z.string().optional(),\n  description: z.string().optional(),\n  action: z.string().optional(),\n});\n\n/**\n * Infobip Error Info schema\n */\nexport const InfobipErrorInfoSchema = z.object({\n  groupId: z.number().optional(),\n  groupName: z.string().optional(),\n  id: z.number().optional(),\n  name: z.string().optional(),\n  description: z.string().optional(),\n  permanent: z.boolean().optional(),\n});\n\n/**\n * Infobip Price Info schema\n */\nexport const InfobipPriceInfoSchema = z.object({\n  pricePerMessage: z.number().optional(),\n  currency: z.string().optional(),\n});\n\n/**\n * Infobip Delivery Result schema\n */\nexport const InfobipDeliveryResultSchema = z\n  .object({\n    messageId: z.string().optional(),\n    to: z.string().optional(),\n    bulkId: z.string().optional(),\n    sentAt: z.string().optional(),\n    doneAt: z.string().optional(),\n    status: InfobipEmailStatusSchema.optional(),\n    error: InfobipErrorInfoSchema.optional(),\n    attemptCount: z.number().optional(),\n    timeToFirstAttempt: z.number().optional(),\n    sendingIp: z.string().optional(),\n    price: InfobipPriceInfoSchema.optional(),\n    smsCount: z.number().optional(),\n    browserLink: z.string().optional(),\n    applicationId: z.string().optional(),\n    entityId: z.string().optional(),\n    campaignReferenceId: z.string().optional(),\n    callbackData: z.string().optional(),\n  })\n  .loose();\n\n/**\n * Infobip Delivery Webhook Payload schema\n */\nexport const InfobipDeliveryWebhookSchema = z.object({\n  results: z.array(InfobipDeliveryResultSchema),\n});\n\n// ============================================================================\n// INFOBIP EMAIL TRACKING WEBHOOK SCHEMAS\n// ============================================================================\n\n/**\n * Infobip Geo Location schema\n */\nexport const InfobipGeoLocationSchema = z\n  .object({\n    countryName: z.string().optional(),\n    countryCode: z.string().optional(),\n    regionName: z.string().optional(),\n    city: z.string().optional(),\n    latitude: z.number().optional(),\n    longitude: z.number().optional(),\n  })\n  .loose();\n\n/**\n * Infobip Recipient Info schema\n */\nexport const InfobipRecipientInfoSchema = z\n  .object({\n    messageId: z.number().optional(),\n    to: z.string().optional(),\n    requestId: z.string().optional(),\n    sentDateTime: z.number().optional(),\n  })\n  .loose();\n\n/**\n * Infobip Tracking Event schema\n */\nexport const InfobipTrackingEventSchema = z\n  .object({\n    messageId: z.number().optional(),\n    bulkId: z.string().optional(),\n    recipient: z.string().optional(),\n    sender: z.string().optional(),\n    domain: z.string().optional(),\n    notificationType: z.string().optional(), // OPENED, CLICKED, COMPLAINED, LATE_BOUNCE, UNSUBSCRIBED\n    eventId: z.string().optional(),\n    sendDateTime: z.number().optional(),\n    url: z.string().optional(), // For CLICKED events\n    applicationId: z.string().optional(),\n    entityId: z.string().optional(),\n    campaignReferenceId: z.string().optional(),\n    callbackData: z.string().optional(),\n    geoLocation: InfobipGeoLocationSchema.optional(),\n    recipientInfo: InfobipRecipientInfoSchema.optional(),\n  })\n  .loose();\n\n/**\n * Infobip Tracking Webhook Payload schema\n * Note: Tracking webhooks send a single event object, not an array\n */\nexport const InfobipTrackingWebhookSchema = z\n  .object({\n    messageId: z.number().optional(),\n    bulkId: z.string().optional(),\n    recipient: z.string().optional(),\n    sender: z.string().optional(),\n    domain: z.string().optional(),\n    notificationType: z.string().optional(),\n    eventId: z.string().optional(),\n    sendDateTime: z.number().optional(),\n    url: z.string().optional(),\n    applicationId: z.string().optional(),\n    entityId: z.string().optional(),\n    campaignReferenceId: z.string().optional(),\n    callbackData: z.string().optional(),\n    geoLocation: InfobipGeoLocationSchema.optional(),\n    recipientInfo: InfobipRecipientInfoSchema.optional(),\n  })\n  .loose();\n\n// ============================================================================\n// SENDGRID WEBHOOK SCHEMAS\n// ============================================================================\n\n/**\n * SendGrid Event schema\n */\nexport const SendGridEventSchema = z\n  .object({\n    email: z.string().email(),\n    timestamp: z.number(),\n    event: z.enum([\n      'processed',\n      'dropped',\n      'delivered',\n      'deferred',\n      'bounce',\n      'open',\n      'click',\n      'spam_report',\n      'unsubscribe',\n      'group_unsubscribe',\n      'group_resubscribe',\n    ]),\n    sg_event_id: z.string(),\n    sg_message_id: z.string(),\n\n    // Custom args (our notification metadata)\n    notification_id: z.string().optional(),\n    recipient_id: z.string().optional(),\n    category: z.string().optional(),\n\n    // Event-specific fields\n    url: z.string().optional(), // For click events\n    reason: z.string().optional(), // For bounce/drop events\n    status: z.string().optional(), // For drop/bounce events\n    response: z.string().optional(), // For bounce events\n    useragent: z.string().optional(), // For open/click events\n    ip: z.string().optional(), // For open/click events\n\n    // Unsubscribe-specific\n    asm_group_id: z.number().optional(), // Unsubscribe group ID\n  })\n  .loose(); // Allow additional fields\n\n/**\n * SendGrid Webhook Payload schema (array of events)\n */\nexport const SendGridWebhookSchema = z.array(SendGridEventSchema);\n\n// ============================================================================\n// TYPE EXPORTS\n// ============================================================================\n\n// Infobip webhook-specific types (prefixed to avoid collision with API types)\nexport type InfobipWebhookEmailStatus = z.infer<typeof InfobipEmailStatusSchema>;\nexport type InfobipWebhookErrorInfo = z.infer<typeof InfobipErrorInfoSchema>;\nexport type InfobipWebhookPriceInfo = z.infer<typeof InfobipPriceInfoSchema>;\nexport type InfobipWebhookDeliveryResult = z.infer<typeof InfobipDeliveryResultSchema>;\nexport type InfobipWebhookDeliveryPayload = z.infer<typeof InfobipDeliveryWebhookSchema>;\n\nexport type InfobipWebhookGeoLocation = z.infer<typeof InfobipGeoLocationSchema>;\nexport type InfobipWebhookRecipientInfo = z.infer<typeof InfobipRecipientInfoSchema>;\nexport type InfobipWebhookTrackingEvent = z.infer<typeof InfobipTrackingEventSchema>;\nexport type InfobipWebhookTrackingPayload = z.infer<typeof InfobipTrackingWebhookSchema>;\n\n// SendGrid webhook types\nexport type SendGridWebhookEvent = z.infer<typeof SendGridEventSchema>;\nexport type SendGridWebhookPayload = z.infer<typeof SendGridWebhookSchema>;\n"]}

package/dist/notifications/schemas.d.ts

@@ -13,7 +13,7 @@ import { z } from 'zod';
  * - Max 255 characters
  * - Automatically lowercased and trimmed
  */
-export declare const EmailSchema: z.ZodEffects<z.ZodString, string, string>;
+export declare const EmailSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
 /**
  * Phone number validation (E.164 format)
  * - Must start with optional + followed by country code
@@ -47,11 +47,21 @@ export declare const LocaleSchema: z.ZodString;
  * - marketing: User can opt-out
  * - social: User can opt-out
  */
-export declare const NotificationCategorySchema: z.ZodDefault<z.ZodEnum<["transactional", "marketing", "social", "system", "promotional"]>>;
+export declare const NotificationCategorySchema: z.ZodDefault<z.ZodEnum<{
+    system: "system";
+    transactional: "transactional";
+    marketing: "marketing";
+    social: "social";
+    promotional: "promotional";
+}>>;
 /**
  * Queue priority validation
  */
-export declare const QueuePrioritySchema: z.ZodEnum<["high", "normal", "low"]>;
+export declare const QueuePrioritySchema: z.ZodEnum<{
+    high: "high";
+    normal: "normal";
+    low: "low";
+}>;
 /**
  * Correlation ID validation
  * - UUID v4 format

package/dist/notifications/types.d.ts

@@ -7,7 +7,7 @@
  * @module notifications/types
  */
 import type { UnknownRecord, Promisable } from 'type-fest';
-import type { MessageCatalog } from '../errors';
+import type { MessageCatalog, PackageErrorLike } from '../errors';
 import type { WEBHOOK_ENCRYPTION_METHOD, WEBHOOK_EVENT_TYPE, SIGNATURE_METHOD } from './enums';
 import type z from 'zod';
 /**
@@ -271,23 +271,6 @@ export interface MockProviderConfig extends UnknownRecord {
     delayMs?: number;
     fallbackAdapter?: unknown;
 }
-/**
- * Attachment definition
- */
-export interface Attachment {
-    /** File name */
-    filename: string;
-    /** File content (base64 encoded or Buffer) */
-    content?: string | globalThis.Buffer;
-    /** URL to fetch the file from */
-    url?: string;
-    /** MIME type */
-    type?: string;
-    /** Content disposition (attachment or inline) */
-    disposition?: 'attachment' | 'inline';
-    /** Content ID for inline attachments */
-    contentId?: string;
-}
 /**
  * Notification input sent to adapters
  */
@@ -358,7 +341,7 @@ export interface SendEmailParams {
     /** Correlation ID for tracking (auto-generated if not provided) */
     correlationId?: string;
     /** File attachments for the email */
-    attachments?: Attachment[];
+    attachments?: NotificationAttachment[];
     /**
      * Notification category (default: 'transactional')
      * Determines opt-out behavior
@@ -1175,7 +1158,7 @@ export interface AttachmentValidationResult {
 export interface AttachmentValidationError {
     type: AttachmentErrorType;
     message: string;
-    attachment?: Attachment;
+    attachment?: NotificationAttachment;
     metadata?: Record<string, unknown>;
 }
 /**
@@ -1414,6 +1397,65 @@ export interface NotificationAdapter {
     getUrlShortenerConfig?(): UrlShortenerConfig | undefined;
     /** Validate email addresses (Email adapters only) */
     validateEmails?(emails: string[]): Promise<NotificationResult<EmailValidationResult[]>>;
+    /**
+     * Generate a secure token URL for actions like unsubscribe, preference updates, etc.
+     * @param type - Type of token (unsubscribe_url, preferences_url, etc.)
+     * @param category - Notification category
+     * @param recipientId - Recipient identifier
+     * @param metadata - Additional metadata to include in token
+     * @returns Generated URL or undefined if token generation not configured
+     */
+    generateSecureTokenUrl?(type: TokenType, category: string, recipientId: string, metadata?: {
+        templateName?: string;
+        emailHash?: string;
+        correlationId?: string;
+        [key: string]: unknown;
+    }): string | undefined;
+}
+/**
+ * NotificationAdapter extended with token generation capabilities
+ * Used when an adapter supports secure token URL generation
+ */
+export type NotificationAdapterWithTokens = NotificationAdapter & {
+    /** Token generation method */
+    generateSecureTokenUrl?: (type: TokenType, category: string, recipientId: string, metadata?: {
+        templateName?: string;
+        emailHash?: string;
+        correlationId?: string;
+        [key: string]: unknown;
+    }) => string | undefined;
+    /** Token configuration */
+    tokenConfig?: TokenConfig;
+    /** Token URL configuration */
+    tokenUrls?: TokenUrlConfig;
+};
+/**
+ * Parameters for token URL generation
+ * Used internally by NotificationService when generating secure URLs
+ */
+export interface TokenUrlGenerationParams {
+    /** Notification category (optional for filtering) */
+    category: string | undefined;
+    /** Recipient identifier */
+    recipientId: string;
+    /** Recipient contact info (email, phone) for hashing */
+    recipientContact: string;
+    /** Template identifier */
+    templateId: string;
+    /** Optional correlation ID */
+    correlationId?: string;
+}
+/**
+ * Prepared data for bulk notification operations
+ * Used internally by NotificationService when processing bulk requests
+ */
+export interface BulkNotificationPreparedData<TParams = SendEmailParams | SendSMSParams | SendPushParams> {
+    /** Index in the original request array */
+    index: number;
+    /** Original request parameters */
+    params: TParams;
+    /** Prepared notification input ready for sending */
+    input: NotificationInput;
 }
 /**
  * ProviderPlugin - Factory pattern for creating provider adapters
@@ -1460,10 +1502,10 @@ export interface PreferenceChecker {
  * Error handler callbacks
  */
 export interface NotificationErrorHandlers {
-    onProviderError?: (error: Error) => Promisable<void>;
-    onQueueError?: (error: Error) => Promisable<void>;
-    onWebhookError?: (error: Error) => Promisable<void>;
-    onAnyError?: (error: Error) => Promisable<void>;
+    onProviderError?: (error: PackageErrorLike) => Promisable<void>;
+    onQueueError?: (error: PackageErrorLike) => Promisable<void>;
+    onWebhookError?: (error: PackageErrorLike) => Promisable<void>;
+    onAnyError?: (error: PackageErrorLike) => Promisable<void>;
 }
 /**
  * NotificationServiceConfig - Main service configuration