blendsdk 5.33.0

package/dist/webafx-mailer/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Type definitions and constants for the @blendsdk/webafx-mailer package.
+ *
+ * Defines mail message structures, provider configuration interfaces,
+ * and the factory configuration with type discriminator for environment-based
+ * backend switching.
+ */
+/**
+ * Email attachment definition.
+ *
+ * Represents a file to attach to an outgoing email. Content can be
+ * provided as a raw Buffer or a base64-encoded string.
+ */
+export interface MailAttachment {
+    /** Filename for the attachment (e.g., "report.pdf") */
+    filename: string;
+    /** Attachment content — Buffer for binary data, or base64-encoded string */
+    content: Buffer | string;
+    /** MIME content type (e.g., "application/pdf", "text/plain") */
+    contentType?: string;
+}
+/**
+ * Email message to send.
+ *
+ * Represents a complete outgoing email. At least one of `text` or `html`
+ * should be provided for message body content.
+ */
+export interface MailMessage {
+    /** Sender email address (e.g., "noreply@example.com" or "Name <email>") */
+    from: string;
+    /** Recipient(s) — single address or array of addresses */
+    to: string | string[];
+    /** CC recipient(s) — optional carbon copy addresses */
+    cc?: string | string[];
+    /** BCC recipient(s) — optional blind carbon copy addresses */
+    bcc?: string | string[];
+    /** Email subject line */
+    subject: string;
+    /** Plain text body — used as fallback when HTML is also provided */
+    text?: string;
+    /** HTML body — rich email content */
+    html?: string;
+    /** File attachments */
+    attachments?: MailAttachment[];
+}
+/**
+ * Result of a send operation.
+ *
+ * Contains information about which recipients accepted or rejected
+ * the message, plus the server-assigned message ID.
+ */
+export interface MailResult {
+    /** Email addresses that accepted the message */
+    accepted: string[];
+    /** Email addresses that rejected the message */
+    rejected: string[];
+    /** Message ID assigned by the mail server (e.g., "<abc123@smtp.example.com>") */
+    messageId?: string;
+}
+/**
+ * Base configuration shared by all mail providers.
+ *
+ * Every provider implementation accepts at least these options.
+ */
+export interface MailProviderConfig {
+    /**
+     * Service name for WebAFX service container registration.
+     * Default: "mailer". Use different names for multi-provider scenarios
+     * (e.g., "transactional-mailer", "marketing-mailer").
+     */
+    serviceName?: string;
+}
+/**
+ * SMTP-specific mail configuration.
+ *
+ * Extends the base config with all settings needed to connect to
+ * an SMTP server via nodemailer.
+ */
+export interface SmtpMailConfig extends MailProviderConfig {
+    /** SMTP server hostname (e.g., "smtp.example.com") */
+    host: string;
+    /** SMTP server port (common: 25, 465 for TLS, 587 for STARTTLS) */
+    port: number;
+    /** Use direct TLS connection (true for port 465, false for STARTTLS on 587) */
+    secure?: boolean;
+    /** SMTP authentication credentials — omit for unauthenticated servers */
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    /** Additional TLS options — allows configuring certificate validation etc. */
+    tls?: {
+        rejectUnauthorized?: boolean;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Memory-specific mail configuration.
+ *
+ * No additional fields beyond the base config. The memory provider
+ * stores messages in-memory for test assertion purposes.
+ */
+export interface MemoryMailConfig extends MailProviderConfig {
+}
+/**
+ * Factory configuration with type discriminator.
+ *
+ * Used by `createMailProvider()` for environment-based backend switching.
+ * The `type` field determines which provider is instantiated, and
+ * SMTP-specific fields are only used when `type === "smtp"`.
+ */
+export interface MailFactoryConfig {
+    /** Mail backend type — determines which provider to create */
+    type: "smtp" | "memory";
+    /** Service name for WebAFX service container. Default: "mailer" */
+    serviceName?: string;
+    /** SMTP server hostname */
+    host?: string;
+    /** SMTP server port */
+    port?: number;
+    /** Use direct TLS connection */
+    secure?: boolean;
+    /** SMTP authentication credentials */
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    /** Additional TLS options */
+    tls?: {
+        rejectUnauthorized?: boolean;
+        [key: string]: unknown;
+    };
+}
+/** Default service name for mail when not specified in config */
+export declare const DEFAULT_SERVICE_NAME = "mailer";
+//# sourceMappingURL=types.d.ts.map

package/dist/webafx-mailer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACvB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACtD,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,IAAI,CAAC,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,8EAA8E;IAC9E,GAAG,CAAC,EAAE;QACF,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KAC1B,CAAC;CACL;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;CAAG;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC9B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,6BAA6B;IAC7B,GAAG,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAClE;AAMD,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,WAAW,CAAC"}

package/dist/webafx-mailer/types.js

@@ -0,0 +1,13 @@
+/**
+ * Type definitions and constants for the @blendsdk/webafx-mailer package.
+ *
+ * Defines mail message structures, provider configuration interfaces,
+ * and the factory configuration with type discriminator for environment-based
+ * backend switching.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Default service name for mail when not specified in config */
+export const DEFAULT_SERVICE_NAME = "mailer";
+//# sourceMappingURL=types.js.map

package/dist/webafx-mailer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2IH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC"}

package/package.json

@@ -0,0 +1,159 @@
+{
+  "name": "blendsdk",
+  "version": "5.33.0",
+  "description": "Enterprise-grade TypeScript SDK for web applications, database operations, caching, pub/sub, email, i18n, and code generation",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "exports": {
+    "./stdlib": {
+      "types": "./dist/stdlib/index.d.ts",
+      "import": "./dist/stdlib/index.js"
+    },
+    "./cmdline": {
+      "types": "./dist/cmdline/index.d.ts",
+      "import": "./dist/cmdline/index.js"
+    },
+    "./expression": {
+      "types": "./dist/expression/index.d.ts",
+      "import": "./dist/expression/index.js"
+    },
+    "./dbcore": {
+      "types": "./dist/dbcore/index.d.ts",
+      "import": "./dist/dbcore/index.js"
+    },
+    "./postgresql": {
+      "types": "./dist/postgresql/index.d.ts",
+      "import": "./dist/postgresql/index.js"
+    },
+    "./webafx": {
+      "types": "./dist/webafx/index.d.ts",
+      "import": "./dist/webafx/index.js"
+    },
+    "./webafx-cache": {
+      "types": "./dist/webafx-cache/index.d.ts",
+      "import": "./dist/webafx-cache/index.js"
+    },
+    "./webafx-mailer": {
+      "types": "./dist/webafx-mailer/index.d.ts",
+      "import": "./dist/webafx-mailer/index.js"
+    },
+    "./webafx-auth": {
+      "types": "./dist/webafx-auth/index.d.ts",
+      "import": "./dist/webafx-auth/index.js"
+    },
+    "./i18n": {
+      "types": "./dist/i18n/index.d.ts",
+      "import": "./dist/i18n/index.js"
+    },
+    "./i18n-node": {
+      "types": "./dist/i18n/node.d.ts",
+      "import": "./dist/i18n/node.js"
+    },
+    "./webafx-i18n": {
+      "types": "./dist/webafx-i18n/index.d.ts",
+      "import": "./dist/webafx-i18n/index.js"
+    },
+    "./codegen": {
+      "types": "./dist/codegen/index.d.ts",
+      "import": "./dist/codegen/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsx ../../scripts/assemble.ts",
+    "clean": "rm -fR ./dist",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@blendsdk/stdlib": "5.33.0",
+    "@blendsdk/cmdline": "5.33.0",
+    "@blendsdk/expression": "5.33.0",
+    "@blendsdk/dbcore": "5.33.0",
+    "@blendsdk/postgresql": "5.33.0",
+    "@blendsdk/webafx": "5.33.0",
+    "@blendsdk/webafx-cache": "5.33.0",
+    "@blendsdk/webafx-mailer": "5.33.0",
+    "@blendsdk/webafx-auth": "5.33.0",
+    "@blendsdk/i18n": "5.33.0",
+    "@blendsdk/webafx-i18n": "5.33.0",
+    "@blendsdk/codegen": "5.33.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.6.0",
+    "express": "^5.0.0",
+    "cookie-parser": "^1.4.0",
+    "cors": "^2.8.0",
+    "helmet": "^8.0.0",
+    "pg": "^8.18.0",
+    "yesql": "^7.0.0",
+    "ioredis": "^5.9.0",
+    "nodemailer": "^7.0.0",
+    "jose": "^6.0.0",
+    "postgres-array": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "cookie-parser": {
+      "optional": true
+    },
+    "cors": {
+      "optional": true
+    },
+    "helmet": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "yesql": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    },
+    "nodemailer": {
+      "optional": true
+    },
+    "jose": {
+      "optional": true
+    },
+    "postgres-array": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blendsdk/blendsdk.git"
+  },
+  "author": "TrueSoftware B.V.",
+  "license": "MIT",
+  "keywords": [
+    "typescript",
+    "sdk",
+    "enterprise",
+    "web-framework",
+    "express",
+    "database",
+    "postgresql",
+    "cache",
+    "redis",
+    "email",
+    "i18n",
+    "code-generation",
+    "monorepo"
+  ]
+}