@omnitron-dev/titan-mailer 0.0.0-stage → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +174 -2
  3. package/dist/errors.d.ts +8 -0
  4. package/dist/errors.d.ts.map +1 -0
  5. package/dist/errors.js +25 -0
  6. package/dist/errors.js.map +1 -0
  7. package/dist/index.d.ts +9 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +6 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/mailer.module.d.ts +10 -0
  12. package/dist/mailer.module.d.ts.map +1 -0
  13. package/dist/mailer.module.js +52 -0
  14. package/dist/mailer.module.js.map +1 -0
  15. package/dist/mailer.service.d.ts +16 -0
  16. package/dist/mailer.service.d.ts.map +1 -0
  17. package/dist/mailer.service.js +100 -0
  18. package/dist/mailer.service.js.map +1 -0
  19. package/dist/notifications.d.ts +58 -0
  20. package/dist/notifications.d.ts.map +1 -0
  21. package/dist/notifications.js +186 -0
  22. package/dist/notifications.js.map +1 -0
  23. package/dist/postgres-readiness.d.ts +92 -0
  24. package/dist/postgres-readiness.d.ts.map +1 -0
  25. package/dist/postgres-readiness.js +35 -0
  26. package/dist/postgres-readiness.js.map +1 -0
  27. package/dist/postgres.d.ts +57 -0
  28. package/dist/postgres.d.ts.map +1 -0
  29. package/dist/postgres.js +159 -0
  30. package/dist/postgres.js.map +1 -0
  31. package/dist/smtp.d.ts +4 -0
  32. package/dist/smtp.d.ts.map +1 -0
  33. package/dist/smtp.js +54 -0
  34. package/dist/smtp.js.map +1 -0
  35. package/dist/templates.d.ts +12 -0
  36. package/dist/templates.d.ts.map +1 -0
  37. package/dist/templates.js +28 -0
  38. package/dist/templates.js.map +1 -0
  39. package/dist/types.d.ts +53 -0
  40. package/dist/types.d.ts.map +1 -0
  41. package/dist/types.js +2 -0
  42. package/dist/types.js.map +1 -0
  43. package/package.json +61 -3
@@ -0,0 +1,12 @@
1
+ import type { RenderedMail } from './types.js';
2
+ export type MailTemplate<T> = (context: T) => RenderedMail;
3
+ export declare function validateRenderedMail(value: RenderedMail): RenderedMail;
4
+ export declare class MailTemplates<Contexts extends object> {
5
+ private readonly templates;
6
+ constructor(templates: {
7
+ [K in keyof Contexts]: MailTemplate<Contexts[K]>;
8
+ });
9
+ render<K extends keyof Contexts>(name: K, context: Contexts[K]): RenderedMail;
10
+ }
11
+ export declare function escapeMailHtml(value: string): string;
12
+ //# sourceMappingURL=templates.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,YAAY,CAAC;AAC3D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAYtE;AAED,qBAAa,aAAa,CAAC,QAAQ,SAAS,MAAM;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,EAAE;SAAG,CAAC,IAAI,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;KAAE,EAAI;IAChG,MAAM,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,YAAY,CAI5E;CACF;AACD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD"}
@@ -0,0 +1,28 @@
1
+ import { MailDeliveryError } from './errors.js';
2
+ export function validateRenderedMail(value) {
3
+ if (!value ||
4
+ typeof value.subject !== 'string' ||
5
+ !value.subject.trim() ||
6
+ /[\r\n\0]/.test(value.subject) ||
7
+ typeof value.text !== 'string' ||
8
+ !value.text.trim() ||
9
+ (value.html !== undefined && typeof value.html !== 'string'))
10
+ throw new MailDeliveryError('invalid');
11
+ return value;
12
+ }
13
+ export class MailTemplates {
14
+ constructor(templates) {
15
+ this.templates = templates;
16
+ }
17
+ render(name, context) {
18
+ const render = this.templates[name];
19
+ if (typeof render !== 'function')
20
+ throw new MailDeliveryError('invalid');
21
+ return validateRenderedMail(render(context));
22
+ }
23
+ }
24
+ export function escapeMailHtml(value) {
25
+ const chars = { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' };
26
+ return value.replace(/[&<>"']/g, (char) => chars[char]);
27
+ }
28
+ //# sourceMappingURL=templates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,IACE,CAAC,KAAK;QACN,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QACrB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QAClB,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;QAE5D,MAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,aAAa;IACxB,YAA6B,SAA+D;yBAA/D,SAAS;IAAyD,CAAC;IAChG,MAAM,CAA2B,IAAO,EAAE,OAAoB;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,MAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACzE,OAAO,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;CACF;AACD,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,KAAK,GAA2B,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC9G,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,CAAC;AAC3D,CAAC"}
@@ -0,0 +1,53 @@
1
+ import type { DynamicModule, InjectionToken } from '@omnitron-dev/titan/nexus';
2
+ export interface RenderedMail {
3
+ subject: string;
4
+ text: string;
5
+ html?: string;
6
+ }
7
+ export interface MailMessage extends RenderedMail {
8
+ to: string;
9
+ from?: string;
10
+ replyTo?: string;
11
+ messageId?: string;
12
+ headers?: Record<string, string>;
13
+ attachments?: Array<{
14
+ filename: string;
15
+ content: Buffer;
16
+ contentType?: string;
17
+ cid?: string;
18
+ }>;
19
+ }
20
+ export interface MailReceipt {
21
+ messageId: string;
22
+ accepted: string[];
23
+ }
24
+ export interface MailSender {
25
+ send(message: MailMessage): Promise<MailReceipt>;
26
+ }
27
+ export interface MailerOptions {
28
+ smtp: string;
29
+ from: string;
30
+ replyTo?: string;
31
+ allowInsecureLocalhost?: boolean;
32
+ pool?: {
33
+ maxConnections?: number;
34
+ maxMessages?: number;
35
+ };
36
+ maxPending?: number;
37
+ timeouts?: {
38
+ connection?: number;
39
+ greeting?: number;
40
+ socket?: number;
41
+ dns?: number;
42
+ };
43
+ verifyOnStart?: boolean;
44
+ }
45
+ export interface MailerAsyncOptions<Args extends unknown[] = unknown[]> {
46
+ imports?: DynamicModule['imports'];
47
+ inject?: {
48
+ [K in keyof Args]: InjectionToken<Args[K]>;
49
+ };
50
+ useFactory: (...args: Args) => MailerOptions | Promise<MailerOptions>;
51
+ global?: boolean;
52
+ }
53
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChG;AACD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AACD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClD;AACD,MAAM,WAAW,aAAa;IAE5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AACD,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE;IACpE,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IACxD,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
package/package.json CHANGED
@@ -1,6 +1,64 @@
1
1
  {
2
2
  "name": "@omnitron-dev/titan-mailer",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.3.2",
4
+ "description": "Lifecycle-managed transactional email for Titan with Nodemailer and durable notification workers",
5
+ "author": "LuxQuant",
6
+ "license": "MIT",
7
+ "type": "module",
8
+ "main": "dist/index.js",
9
+ "types": "dist/index.d.ts",
10
+ "exports": {
11
+ ".": {
12
+ "types": "./dist/index.d.ts",
13
+ "default": "./dist/index.js"
14
+ },
15
+ "./notifications": {
16
+ "types": "./dist/notifications.d.ts",
17
+ "default": "./dist/notifications.js"
18
+ },
19
+ "./postgres": {
20
+ "types": "./dist/postgres.d.ts",
21
+ "default": "./dist/postgres.js"
22
+ }
23
+ },
24
+ "files": [
25
+ "dist",
26
+ "README.md"
27
+ ],
28
+ "dependencies": {
29
+ "@types/nodemailer": "^8.0.2",
30
+ "nodemailer": "^10.3.1",
31
+ "reflect-metadata": "^0.2.2"
32
+ },
33
+ "peerDependencies": {
34
+ "@omnitron-dev/titan": "^0.3.0",
35
+ "@omnitron-dev/titan-notifications": "^0.3.0"
36
+ },
37
+ "peerDependenciesMeta": {
38
+ "@omnitron-dev/titan-notifications": {
39
+ "optional": true
40
+ }
41
+ },
42
+ "devDependencies": {
43
+ "@omnitron-dev/titan": "0.3.2",
44
+ "@omnitron-dev/titan-notifications": "0.3.2",
45
+ "@types/mailparser": "^3.9.0",
46
+ "@types/smtp-server": "^3.5.13",
47
+ "mailparser": "^3.14.1",
48
+ "smtp-server": "^3.21.3",
49
+ "typescript": "npm:@typescript/typescript6@^6.0.2",
50
+ "vitest": "^5.0.5",
51
+ "@typescript/native": "npm:typescript@^7.0.2"
52
+ },
53
+ "repository": {
54
+ "type": "git",
55
+ "url": "git+https://github.com/omnitron-dev/omni.git",
56
+ "directory": "packages/titan-mailer"
57
+ },
58
+ "gitHead": "ecf537907f8e7efa75a56012a96c84c451ced77b",
59
+ "scripts": {
60
+ "build": "../../scripts/build-package.sh -p ./tsconfig.json",
61
+ "test": "vitest run",
62
+ "typecheck": "tsc --noEmit"
63
+ }
6
64
  }