@parsrun/email 0.1.0

package/dist/types.js

@@ -0,0 +1,50 @@
+// src/types.ts
+import {
+  type,
+  emailAddress,
+  emailAttachment,
+  sendEmailOptions,
+  sendTemplateEmailOptions,
+  emailSendResult,
+  smtpConfig,
+  resendConfig,
+  sendgridConfig,
+  sesConfig,
+  postmarkConfig,
+  emailConfig
+} from "@parsrun/types";
+var EmailError = class extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "EmailError";
+  }
+};
+var EmailErrorCodes = {
+  INVALID_CONFIG: "INVALID_CONFIG",
+  INVALID_RECIPIENT: "INVALID_RECIPIENT",
+  INVALID_CONTENT: "INVALID_CONTENT",
+  SEND_FAILED: "SEND_FAILED",
+  RATE_LIMITED: "RATE_LIMITED",
+  PROVIDER_ERROR: "PROVIDER_ERROR",
+  TEMPLATE_ERROR: "TEMPLATE_ERROR",
+  ATTACHMENT_ERROR: "ATTACHMENT_ERROR"
+};
+export {
+  EmailError,
+  EmailErrorCodes,
+  emailAddress,
+  emailAttachment,
+  emailConfig,
+  emailSendResult,
+  postmarkConfig,
+  resendConfig,
+  sendEmailOptions,
+  sendTemplateEmailOptions,
+  sendgridConfig,
+  sesConfig,
+  smtpConfig,
+  type
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * @parsrun/email - Type Definitions\n * Email types and interfaces\n */\n\n// Re-export types from @parsrun/types for convenience\nexport {\n  type,\n  emailAddress,\n  emailAttachment,\n  sendEmailOptions,\n  sendTemplateEmailOptions,\n  emailSendResult,\n  smtpConfig,\n  resendConfig,\n  sendgridConfig,\n  sesConfig,\n  postmarkConfig,\n  emailConfig,\n  type EmailAddress as ParsEmailAddress,\n  type EmailAttachment as ParsEmailAttachment,\n  type SendEmailOptions,\n  type SendTemplateEmailOptions,\n  type EmailSendResult,\n  type SmtpConfig,\n  type ResendConfig,\n  type SendgridConfig,\n  type SesConfig,\n  type PostmarkConfig,\n  type EmailConfig,\n} from \"@parsrun/types\";\n\n/**\n * Email provider type\n */\nexport type EmailProviderType = \"resend\" | \"sendgrid\" | \"postmark\" | \"ses\" | \"console\" | \"mailgun\";\n\n/**\n * Email address with optional name\n */\nexport interface EmailAddress {\n  email: string;\n  name?: string | undefined;\n}\n\n/**\n * Email attachment\n */\nexport interface EmailAttachment {\n  /** File name */\n  filename: string;\n  /** File content (base64 encoded or Buffer) */\n  content: string | Uint8Array;\n  /** Content type (MIME type) */\n  contentType?: string | undefined;\n  /** Content ID for inline attachments */\n  contentId?: string | undefined;\n}\n\n/**\n * Email options\n */\nexport interface EmailOptions {\n  /** Recipient email address(es) */\n  to: string | string[] | EmailAddress | EmailAddress[];\n  /** Email subject */\n  subject: string;\n  /** HTML content */\n  html?: string | undefined;\n  /** Plain text content */\n  text?: string | undefined;\n  /** From address (overrides default) */\n  from?: string | EmailAddress | undefined;\n  /** Reply-to address */\n  replyTo?: string | EmailAddress | undefined;\n  /** CC recipients */\n  cc?: string | string[] | EmailAddress | EmailAddress[] | undefined;\n  /** BCC recipients */\n  bcc?: string | string[] | EmailAddress | EmailAddress[] | undefined;\n  /** Attachments */\n  attachments?: EmailAttachment[] | undefined;\n  /** Custom headers */\n  headers?: Record<string, string> | undefined;\n  /** Tags for tracking */\n  tags?: Record<string, string> | undefined;\n  /** Schedule send time */\n  scheduledAt?: Date | undefined;\n}\n\n/**\n * Email send result\n */\nexport interface EmailResult {\n  /** Whether send was successful */\n  success: boolean;\n  /** Message ID from provider */\n  messageId?: string | undefined;\n  /** Error message if failed */\n  error?: string | undefined;\n  /** Provider-specific response data */\n  data?: unknown;\n}\n\n/**\n * Batch email options\n */\nexport interface BatchEmailOptions {\n  /** List of emails to send */\n  emails: EmailOptions[];\n  /** Whether to stop on first error */\n  stopOnError?: boolean | undefined;\n}\n\n/**\n * Batch email result\n */\nexport interface BatchEmailResult {\n  /** Total emails attempted */\n  total: number;\n  /** Successful sends */\n  successful: number;\n  /** Failed sends */\n  failed: number;\n  /** Individual results */\n  results: EmailResult[];\n}\n\n/**\n * Email provider configuration\n */\nexport interface EmailProviderConfig {\n  /** API key for the provider */\n  apiKey: string;\n  /** Default from email */\n  fromEmail: string;\n  /** Default from name */\n  fromName?: string | undefined;\n  /** Provider-specific options */\n  options?: Record<string, unknown> | undefined;\n}\n\n/**\n * Email provider interface\n */\nexport interface EmailProvider {\n  /** Provider type */\n  readonly type: EmailProviderType;\n\n  /**\n   * Send a single email\n   */\n  send(options: EmailOptions): Promise<EmailResult>;\n\n  /**\n   * Send multiple emails\n   */\n  sendBatch?(options: BatchEmailOptions): Promise<BatchEmailResult>;\n\n  /**\n   * Verify provider configuration\n   */\n  verify?(): Promise<boolean>;\n}\n\n/**\n * Email service configuration\n */\nexport interface EmailServiceConfig {\n  /** Provider type */\n  provider: EmailProviderType;\n  /** API key */\n  apiKey: string;\n  /** Default from email */\n  fromEmail: string;\n  /** Default from name */\n  fromName?: string | undefined;\n  /** Enable debug logging */\n  debug?: boolean | undefined;\n  /** Provider-specific options */\n  providerOptions?: Record<string, unknown> | undefined;\n}\n\n/**\n * Template data for email templates\n */\nexport interface TemplateData {\n  [key: string]: string | number | boolean | undefined | null | TemplateData | TemplateData[];\n}\n\n/**\n * Email template\n */\nexport interface EmailTemplate {\n  /** Template name */\n  name: string;\n  /** Subject template */\n  subject: string;\n  /** HTML template */\n  html: string;\n  /** Plain text template */\n  text?: string | undefined;\n}\n\n/**\n * Email error\n */\nexport class EmailError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly cause?: unknown\n  ) {\n    super(message);\n    this.name = \"EmailError\";\n  }\n}\n\n/**\n * Common email error codes\n */\nexport const EmailErrorCodes = {\n  INVALID_CONFIG: \"INVALID_CONFIG\",\n  INVALID_RECIPIENT: \"INVALID_RECIPIENT\",\n  INVALID_CONTENT: \"INVALID_CONTENT\",\n  SEND_FAILED: \"SEND_FAILED\",\n  RATE_LIMITED: \"RATE_LIMITED\",\n  PROVIDER_ERROR: \"PROVIDER_ERROR\",\n  TEMPLATE_ERROR: \"TEMPLATE_ERROR\",\n  ATTACHMENT_ERROR: \"ATTACHMENT_ERROR\",\n} as const;\n"],"mappings":";AAMA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAYK;AAgLA,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YACE,SACgB,MACA,OAChB;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,kBAAkB;AAAA,EAC7B,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,aAAa;AAAA,EACb,cAAc;AAAA,EACd,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,kBAAkB;AACpB;","names":[]}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@parsrun/email",
+  "version": "0.1.0",
+  "description": "Edge-compatible email sending for Pars - Resend, SendGrid, Postmark, AWS SES",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./providers": {
+      "types": "./dist/providers/index.d.ts",
+      "import": "./dist/providers/index.js"
+    },
+    "./providers/resend": {
+      "types": "./dist/providers/resend.d.ts",
+      "import": "./dist/providers/resend.js"
+    },
+    "./providers/sendgrid": {
+      "types": "./dist/providers/sendgrid.d.ts",
+      "import": "./dist/providers/sendgrid.js"
+    },
+    "./providers/postmark": {
+      "types": "./dist/providers/postmark.d.ts",
+      "import": "./dist/providers/postmark.js"
+    },
+    "./providers/console": {
+      "types": "./dist/providers/console.d.ts",
+      "import": "./dist/providers/console.js"
+    },
+    "./templates": {
+      "types": "./dist/templates/index.d.ts",
+      "import": "./dist/templates/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "email",
+    "resend",
+    "sendgrid",
+    "postmark",
+    "edge",
+    "pars"
+  ],
+  "author": "EMS Tech Solutions",
+  "license": "MIT",
+  "dependencies": {
+    "@parsrun/core": "workspace:*",
+    "@parsrun/types": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "resend": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "resend": {
+      "optional": true
+    }
+  }
+}