@plyaz/types 1.13.2 → 1.13.4

package/dist/notifications/index.js

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+
+// @plyaz package - Built with tsup
+
+// src/notifications/enums.ts
+var NOTIFICATION_PROVIDERS = {
+  /** Infobip omnichannel provider (Email, SMS, WhatsApp) - PRIMARY */
+  INFOBIP: "Infobip",
+  /** SendGrid email provider - FALLBACK */
+  SENDGRID: "SendGrid",
+  /** Mock email provider for testing */
+  MOCK_EMAIL: "MockEmail",
+  /** Mock SMS provider for testing */
+  MOCK_SMS: "MockSMS",
+  /** Mock push provider for testing */
+  MOCK_PUSH: "MockPush"
+};
+var NOTIFICATION_CHANNELS = {
+  EMAIL: "email",
+  SMS: "sms",
+  PUSH: "push"
+};
+var NOTIFICATION_CATEGORIES = {
+  /** Cannot be opted out - compliance requirement (password resets, order confirmations) */
+  TRANSACTIONAL: "transactional",
+  /** User can opt-out (newsletters, promotions) */
+  MARKETING: "marketing",
+  /** User can opt-out (likes, comments, follows) */
+  SOCIAL: "social",
+  /** System alerts and notifications (security alerts, system status) */
+  SYSTEM: "system",
+  /** Promotional offers and campaigns */
+  PROMOTIONAL: "promotional"
+};
+var SIGNATURE_METHOD = /* @__PURE__ */ ((SIGNATURE_METHOD2) => {
+  SIGNATURE_METHOD2["HmacSha256"] = "hmac-sha256";
+  SIGNATURE_METHOD2["HmacSha1"] = "hmac-sha1";
+  SIGNATURE_METHOD2["HmacSha512"] = "hmac-sha512";
+  SIGNATURE_METHOD2["Custom"] = "custom";
+  return SIGNATURE_METHOD2;
+})(SIGNATURE_METHOD || {});
+var WEBHOOK_EVENT_TYPE = /* @__PURE__ */ ((WEBHOOK_EVENT_TYPE2) => {
+  WEBHOOK_EVENT_TYPE2["Delivered"] = "delivered";
+  WEBHOOK_EVENT_TYPE2["Bounced"] = "bounced";
+  WEBHOOK_EVENT_TYPE2["Deferred"] = "deferred";
+  WEBHOOK_EVENT_TYPE2["Dropped"] = "dropped";
+  WEBHOOK_EVENT_TYPE2["Opened"] = "opened";
+  WEBHOOK_EVENT_TYPE2["Clicked"] = "clicked";
+  WEBHOOK_EVENT_TYPE2["SpamReport"] = "spam_report";
+  WEBHOOK_EVENT_TYPE2["Unsubscribed"] = "unsubscribed";
+  WEBHOOK_EVENT_TYPE2["SmsDelivered"] = "sms_delivered";
+  WEBHOOK_EVENT_TYPE2["SmsFailed"] = "sms_failed";
+  WEBHOOK_EVENT_TYPE2["PushDelivered"] = "push_delivered";
+  WEBHOOK_EVENT_TYPE2["PushFailed"] = "push_failed";
+  WEBHOOK_EVENT_TYPE2["Unknown"] = "unknown";
+  return WEBHOOK_EVENT_TYPE2;
+})(WEBHOOK_EVENT_TYPE || {});
+var WEBHOOK_ENCRYPTION_METHOD = /* @__PURE__ */ ((WEBHOOK_ENCRYPTION_METHOD2) => {
+  WEBHOOK_ENCRYPTION_METHOD2["HmacSha256"] = "hmac-sha256";
+  WEBHOOK_ENCRYPTION_METHOD2["HmacSha512"] = "hmac-sha512";
+  WEBHOOK_ENCRYPTION_METHOD2["None"] = "none";
+  return WEBHOOK_ENCRYPTION_METHOD2;
+})(WEBHOOK_ENCRYPTION_METHOD || {});
+var MIME_TYPES = {
+  // Documents
+  PDF: "application/pdf",
+  DOC: "application/msword",
+  DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  XLS: "application/vnd.ms-excel",
+  XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  PPT: "application/vnd.ms-powerpoint",
+  PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  TXT: "text/plain",
+  CSV: "text/csv",
+  // Images
+  PNG: "image/png",
+  JPG: "image/jpeg",
+  JPEG: "image/jpeg",
+  GIF: "image/gif",
+  SVG: "image/svg+xml",
+  WEBP: "image/webp",
+  // Archives
+  ZIP: "application/zip",
+  RAR: "application/x-rar-compressed",
+  TAR: "application/x-tar",
+  GZIP: "application/gzip",
+  // Other
+  JSON: "application/json",
+  XML: "application/xml"
+};
+var FILE_EXTENSIONS = {
+  // Documents
+  PDF: ".pdf",
+  DOC: ".doc",
+  DOCX: ".docx",
+  XLS: ".xls",
+  XLSX: ".xlsx",
+  PPT: ".ppt",
+  PPTX: ".pptx",
+  TXT: ".txt",
+  CSV: ".csv",
+  // Images
+  PNG: ".png",
+  JPG: ".jpg",
+  JPEG: ".jpeg",
+  GIF: ".gif",
+  SVG: ".svg",
+  WEBP: ".webp",
+  // Archives
+  ZIP: ".zip",
+  RAR: ".rar",
+  TAR: ".tar",
+  GZ: ".gz",
+  GZIP: ".gzip",
+  // Other
+  JSON: ".json",
+  XML: ".xml"
+};
+var MAX_EMAIL_LENGTH = 255;
+var MAX_USER_ID_LENGTH = 255;
+var MAX_TEMPLATE_ID_LENGTH = 255;
+var MAX_DEVICE_TOKEN_LENGTH = 512;
+var EmailSchema = z.string().email("Invalid email address format").max(MAX_EMAIL_LENGTH, "Email address must be 255 characters or less").transform((val) => val.trim().toLowerCase());
+var PhoneSchema = z.string().regex(/^\+?[1-9]\d{1,14}$/, "Invalid phone number format (E.164 expected)").describe("Phone number in E.164 format");
+var UserIdSchema = z.string().min(1, "User ID is required").max(MAX_USER_ID_LENGTH, "User ID must be 255 characters or less");
+var TemplateIdSchema = z.string().min(1, "Template ID is required").regex(
+  /^[a-z0-9-/]+$/,
+  "Template ID must contain only lowercase letters, numbers, hyphens, and slashes"
+).max(MAX_TEMPLATE_ID_LENGTH, "Template ID must be 255 characters or less");
+var LocaleSchema = z.string().regex(/^[a-z]{2}(-[A-Z]{2})?$/, "Locale must be in format: en, en-US, es, es-MX").describe("Locale in ISO 639-1 format");
+var NotificationCategorySchema = z.enum([
+  NOTIFICATION_CATEGORIES.TRANSACTIONAL,
+  NOTIFICATION_CATEGORIES.MARKETING,
+  NOTIFICATION_CATEGORIES.SOCIAL,
+  NOTIFICATION_CATEGORIES.SYSTEM,
+  NOTIFICATION_CATEGORIES.PROMOTIONAL
+]).default(NOTIFICATION_CATEGORIES.TRANSACTIONAL).describe("Notification category for compliance and user preferences");
+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");
+
+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 };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +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 * Configuration defaults have been moved to @plyaz/config/notifications.\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"]}

package/dist/notifications/schemas.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Notification Validation Schemas
+ *
+ * Zod schemas for validating notification inputs
+ * Ensures type safety and prevents invalid data from entering the system
+ *
+ * @module notifications/schemas
+ */
+import { z } from 'zod';
+/**
+ * Email address validation
+ * - Must be valid email format
+ * - Max 255 characters
+ * - Automatically lowercased and trimmed
+ */
+export declare const EmailSchema: z.ZodEffects<z.ZodString, string, string>;
+/**
+ * Phone number validation (E.164 format)
+ * - Must start with optional + followed by country code
+ * - 1-15 digits total (E.164 standard)
+ * - Examples: +14155552671, +442071838750, +8613800000000
+ */
+export declare const PhoneSchema: z.ZodString;
+/**
+ * User ID validation
+ * - Required, non-empty string
+ * - Max 255 characters
+ */
+export declare const UserIdSchema: z.ZodString;
+/**
+ * Template ID validation
+ * - Only lowercase letters, numbers, hyphens, and slashes
+ * - Used for file path construction, must be safe
+ * - Examples: welcome, password-reset, order/confirmation
+ */
+export declare const TemplateIdSchema: z.ZodString;
+/**
+ * Locale validation
+ * - ISO 639-1 language code (2 lowercase letters)
+ * - Optional ISO 3166-1 country code (2 uppercase letters)
+ * - Examples: en, en-US, es, es-MX, fr-FR
+ */
+export declare const LocaleSchema: z.ZodString;
+/**
+ * Notification category validation (FR-4.3)
+ * - transactional: Cannot be opted out (compliance requirement)
+ * - marketing: User can opt-out
+ * - social: User can opt-out
+ */
+export declare const NotificationCategorySchema: z.ZodDefault<z.ZodEnum<["transactional", "marketing", "social", "system", "promotional"]>>;
+/**
+ * Queue priority validation
+ */
+export declare const QueuePrioritySchema: z.ZodEnum<["high", "normal", "low"]>;
+/**
+ * Correlation ID validation
+ * - UUID v4 format
+ * - Used for tracing across systems
+ */
+export declare const CorrelationIdSchema: z.ZodString;
+/**
+ * Template data validation
+ * - Must be a valid object
+ * - Can contain strings, numbers, booleans, or nested objects
+ * - Arrays are allowed
+ */
+export declare const TemplateDataSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+/**
+ * Device token validation (for push notifications)
+ * - Non-empty string
+ * - Max 512 characters (FCM tokens can be quite long)
+ */
+export declare const DeviceTokenSchema: z.ZodString;